std:: integer_sequence
|
Definido en el 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 utiliza como argumento para una
plantilla de función
, el
paquete de parámetros
Ints
puede ser deducido y utilizado en la expansión de paquetes.
Contenidos |
Parámetros de plantilla
| T | - | un tipo entero para usar en los elementos de la secuencia |
| ...Ints | - | un paquete de parámetros constante que representa la secuencia |
Tipos de miembros
| Tipo | Definición |
value_type
|
T
|
Funciones miembro
|
size
[static]
|
devuelve el número de elementos en
Ints
(función miembro pública estática) |
std::integer_sequence:: size
|
static
constexpr
std::
size_t
size
(
)
noexcept
;
|
||
Devuelve el número de elementos en
Ints
. Equivalente a
sizeof...
(
Ints
)
.
Valor de retorno
El número de elementos en
Ints
.
Plantillas auxiliares
Una plantilla de alias auxiliar
std::index_sequence
está definida 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... > ; |
||
Alias de plantilla auxiliares
std::make_integer_sequence
y
std::make_index_sequence
están definidos 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 negativo. Si
N
es cero, el tipo indicado es
integer_sequence<T>
.
Un alias auxiliar de plantilla
std::index_sequence_for
se define para convertir cualquier paquete de parámetros de tipo en una secuencia de índices de la misma longitud:
|
template
<
class
...
T
>
using index_sequence_for = std :: make_index_sequence < sizeof... ( T ) > ; |
||
Notas
| Macro de prueba de características | Valor | Std | Característica |
|---|---|---|---|
__cpp_lib_integer_sequence
|
201304L
|
(C++14) | Secuencias de enteros en tiempo de compilación |
Implementación posible
| make_integer_sequence |
|---|
namespace detail { template<class T, T I, T N, T... integers> struct make_integer_sequence_helper { using type = typename make_integer_sequence_helper<T, I + 1, N, integers..., I>::type; }; template<class T, T N, T... integers> struct make_integer_sequence_helper<T, N, N, integers...> { using type = std::integer_sequence<T, integers...>; }; } template<class T, T N> using make_integer_sequence = detail::make_integer_sequence_helper<T, 0, N>::type; |
Ejemplo
Véase también std::apply implementación posible para otro ejemplo.
#include <array> #include <cstddef> #include <iostream> #include <tuple> #include <utility> namespace details { template <typename Array, std::size_t... I> constexpr auto array_to_tuple_impl(const Array& a, std::index_sequence<I...>) { return std::make_tuple(a[I]...); } template <class Ch, class Tr, class Tuple, std::size_t... Es> void print_tuple_impl(std::basic_ostream<Ch, Tr>& os, const Tuple& t, std::index_sequence<Is...>) { ((os << (Is ? ", " : "") << std::get<Is>(t)), ...); } } template <typename T, T... ints> void print_sequence(int id, std::integer_sequence<T, ints...> int_seq) { std::cout << id << ") La secuencia de tamaño " << int_seq.size() << ": "; ((std::cout << ints << ' '), ...); std::cout << '\n'; } template <typename T, std::size_t N, typename Indx = std::make_index_sequence<N>> constexpr auto array_to_tuple(const std::array<T, N>& a) { return details::array_to_tuple_impl(a, Indx{}); } template <class Ch, class Tr, class... Args> auto& operator<<(std::basic_ostream<Ch, Tr>& os, const std::tuple<Args...>& t) { os << '('; details::print_tuple_impl(os, t, std::index_sequence_for<Args...>{}); return os << ')'; } int main() { print_sequence(1, std::integer_sequence<unsigned, 9, 2, 5, 1, 9, 1, 6>{}); print_sequence(2, std::make_integer_sequence<int, 12>{}); print_sequence(3, std::make_index_sequence<10>{}); print_sequence(4, std::index_sequence_for<std::ios, float, signed>{}); constexpr std::array<int, 4> array{1, 2, 3, 4}; auto tuple1 = array_to_tuple(array); static_assert(std::is_same_v<decltype(tuple1), std::tuple<int, int, int, int>>, ""); std::cout << "5) tuple1: " << tuple1 << '\n'; constexpr auto tuple2 = array_to_tuple<int, 4, std::integer_sequence<std::size_t, 1, 0, 3, 2>>(array); std::cout << "6) tuple2: " << tuple2 << '\n'; }
Salida:
1) La secuencia de tamaño 7: 9 2 5 1 9 1 6 2) La secuencia de tamaño 12: 0 1 2 3 4 5 6 7 8 9 10 11 3) La secuencia de tamaño 10: 0 1 2 3 4 5 6 7 8 9 4) La secuencia de tamaño 3: 0 1 2 5) tuple1: (1, 2, 3, 4) 6) tuple2: (2, 1, 4, 3)
Véase también
|
(C++20)
|
crea un objeto
std::array
a partir de un array incorporado
(plantilla de función) |
|
(C++11)
(C++17)
|
constante en tiempo de compilación de tipo especificado con valor especificado
(plantilla de clase) |