# sol2 3.5.0 documentation

## as_args

### Search the Documentation

# as_args

turn an iterable argument into multiple arguments

    template <typename T>
    struct 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:

args_from_container.cpp

     1#define SOL_ALL_SAFETIES_ON 1
     2#include <sol/sol.hpp>
     3
     4#include <iostream>
     5#include <vector>
     6#include <set>
     7
     8int main(int, const char*[]) {
     9
    10	std::cout << "=== args_from_container ===" << std::endl;
    11
    12	sol::state lua;
    13	lua.open_libraries();
    14
    15	lua.script("function f (a, b, c, d) print(a, b, c, d) end");
    16
    17	sol::function f = lua["f"];
    18
    19	std::vector<int> v2 { 3, 4 };
    20	f(1, 2, sol::as_args(v2));
    21
    22	std::set<int> v4 { 3, 1, 2, 4 };
    23	f(sol::as_args(v4));
    24
    25	int v3[] = { 2, 3, 4 };
    26	f(1, sol::as_args(v3));
    27
    28	std::cout << std::endl;
    29
    30	return 0;
    31}

It is basically implemented as a one-way customization point. For more information about customization points, see the tutorial on how to customize sol to work with your types.