sol2/documentation/source/api/as_args.rst

26 lines
835 B
ReStructuredText
Raw Normal View History

2016-11-27 02:58:06 +08:00
as_args
=======
*turn an iterable argument into multiple arguments*
2016-11-27 02:58:06 +08:00
.. code-block:: cpp
template <typename T>
struct as_args_t { ... };
2016-11-27 02:58:06 +08:00
template <typename T>
as_args_t<T> as_args( T&& );
``sol::as_args`` is a function that that takes an iterable and turns it into multiple arguments to a function call. It forwards its arguments, and is meant to be used as shown below:
.. literalinclude:: ../../../examples/source/args_from_container.cpp
:caption: args_from_container.cpp
2019-07-18 17:06:28 +08:00
:name: args-from-container
:linenos:
2016-11-27 03:04:44 +08:00
It is basically implemented as a `one-way customization point`_. For more information about customization points, see the :doc:`tutorial on how to customize sol to work with your types<../tutorial/customization>`.
2016-11-27 03:04:44 +08:00
.. _one-way customization point: https://github.com/ThePhD/sol2/blob/develop/sol/as_args.hpp