std::integer_sequence
| 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.
Contenido |
[editar] 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. |
[editar] Tipos miembro
| Tipo miembro | Definición |
value_type
|
T
|
[editar] Funciones miembro
| size [estático] |
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.
[editar] 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)>; |
||
[editar] 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)
