std::integer_sequence - cppreference.com

Definido en el archivo de encabezado `<utility>`
`template< class T, T... Ints > class integer_sequence;`		(desde C++14)

La plantilla de clase std::integer_sequence representa una secuencia de enteros en tiempo de compilación. Cuando se usa como un argumento para una plantilla de función, el paquete de parámetros Ints puede deducirse y usarse en la expansión del paquete.

Parámetros de plantilla

T	-	Un tipo entero a usar para los elementos de la secuencia.
...Ints	-	Un paquete de parámetros sin tipo que representan la secuencia.

Tipos miembro

Tipo miembro	Definición
`value_type`	`T`

Funciones miembro

Devuelve el número de elementos en Ints.
(función miembro estática pública)

std::integer_sequence::size

`static constexpr std::size_t size() noexcept;`

Devuelve el número de elementos en Ints. Equivalente a sizeof...(Ints).

Parámetros

(Ninguno)

Valor de retorno

El número de elementos en Ints.

Plantillas auxiliares

Una plantilla de alias auxiliar std::index_sequence se define para el caso común donde T es std::size_t:

`template<std::size_t... Ints> using index_sequence = std::integer_sequence<std::size_t, Ints...>;`

Las plantillas de alias auxiliares std::make_integer_sequence y std::make_index_sequence se definen para simplificar la creación de los tipos std::integer_sequence y std::index_sequence, respectivamente, con 0, 1, 2, ..., N-1 como Ints:

`template<class T, T N> using make_integer_sequence = std::integer_sequence<T, /* una secuencia 0, 1, 2, ..., N-1 */ >;`
`template<std::size_t N> using make_index_sequence = std::make_integer_sequence<std::size_t, N>;`

El programa está mal formado si N es negativa. Si N es cero, el tipo indicado es integer_sequence<T>.

Una plantilla de alias auxiliar std::index_sequence_for se define para convertir cualquier paquete de parámetros con tipo en una secuencia de índices de la misma longitud:

`template<class... T> using index_sequence_for = std::make_index_sequence<sizeof...(T)>;`

Ejemplo

Nota: véase la sección Posible implementación en std::apply para otro ejemplo.

#include <tuple>
#include <iostream>
#include <array>
#include <utility>

// asiste en la depuración
template<typename T, T... ints>
void print_sequence(std::integer_sequence<T, ints...> int_seq)
{
    std::cout << "La secuencia de tamaño " << int_seq.size() << ": ";
    ((std::cout << ints << ' '),...);
    std::cout << '\n';
}

// Convertir array en una tupla
template<typename Array, std::size_t... I>
auto a2t_impl(const Array& a, std::index_sequence<I...>)
{
    return std::make_tuple(a[I]...);
}

template<typename T, std::size_t N, typename Indices = std::make_index_sequence<N>>
auto a2t(const std::array<T, N>& a)
{
    return a2t_impl(a, Indices{});
}

// imprimir una tupla

template<class Ch, class Tr, class Tuple, std::size_t... Is>
void print_tuple_impl(std::basic_ostream<Ch,Tr>& os,
                      const Tuple& t,
                      std::index_sequence<Is...>)
{
    ((os << (Is == 0? "" : ", ") << std::get<Is>(t)), ...);
}

template<class Ch, class Tr, class... Args>
auto& operator<<(std::basic_ostream<Ch, Tr>& os,
                 const std::tuple<Args...>& t)
{
    os << "(";
    print_tuple_impl(os, t, std::index_sequence_for<Args...>{});
    return os << ")";
}


int main()
{
    print_sequence(std::integer_sequence<unsigned, 9, 2, 5, 1, 9, 1, 6>{});
    print_sequence(std::make_integer_sequence<int, 20>{});
    print_sequence(std::make_index_sequence<10>{});
    print_sequence(std::index_sequence_for<float, std::iostream, char>{});

    std::array<int, 4> array = {1,2,3,4};

    // convertir un array en una tupla
    auto tuple = a2t(array);
    static_assert(std::is_same<decltype(tuple),
                               std::tuple<int, int, int, int>>::value, "");

    // imprimirla
    std::cout << tuple << '\n';

}

Salida:

La secuencia de tamaño 7: 9 2 5 1 9 1 6 
La secuencia de tamaño 20: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 
La secuencia de tamaño 10: 0 1 2 3 4 5 6 7 8 9 
La secuencia de tamaño 3: 0 1 2 
(1, 2, 3, 4)