summaryrefslogtreecommitdiffstatshomepage
path: root/3rdparty/sol2/docs/source/api/as_args.rst
blob: 8e323fdfabad34f24607459091db39b38dcfb729 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
as_args
=======
turn an iterable argument into multiple arguments
-------------------------------------------------

.. code-block:: cpp
	
	template <typename T>
	as_args_t { ... };

	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:

.. code-block:: cpp
	:caption: as_args.c++

	#define SOL_CHECK_ARGUMENTS
	#include <sol.hpp>

	#include <vector>
	#include <set>

	int main(int argc, const char* argv[]) {
		
		sol::state lua;
		lua.open_libraries();

		lua.script("function f (a, b, c, d) print(a, b, c, d) end");

		sol::function f = lua["f"];

		std::vector<int> v2{ 3, 4 };
		f(1, 2, sol::as_args(v2));

		std::set<int> v4{ 3, 1, 2, 4 };
		f(sol::as_args(v4));

		int v3[] = { 2, 3, 4 };
		f(1, sol::as_args(v3));

		return 0;
	}


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>`.

.. _one-way customization point: https://github.com/ThePhD/sol2/blob/develop/sol/as_args.hpp