std:: integer_sequence
|
Défini dans l'en-tête
<utility>
|
||
|
template
<
class
T, T...
Ints
>
class integer_sequence ; |
(depuis C++14) | |
Le modèle de classe
std::integer_sequence
représente une séquence d'entiers à la compilation. Lorsqu'il est utilisé comme argument pour un
modèle de fonction
, le
pack de paramètres
Ints
peut être déduit et utilisé dans l'expansion de pack.
Table des matières |
Paramètres du modèle
| T | - | un type entier à utiliser pour les éléments de la séquence |
| ...Ints | - | un pack de paramètres constants représentant la séquence |
Types membres
| Type | Définition |
value_type
|
T
|
Fonctions membres
|
size
[static]
|
retourne le nombre d'éléments dans
Ints
(fonction membre publique statique) |
std::integer_sequence:: size
|
static
constexpr
std::
size_t
size
(
)
noexcept
;
|
||
Retourne le nombre d'éléments dans
Ints
. Équivalent à
sizeof...
(
Ints
)
.
Valeur de retour
Le nombre d'éléments dans
Ints
.
Modèles d'assistance
Un alias template auxiliaire
std::index_sequence
est défini pour le cas courant où
T
est
std::size_t
:
|
template
<
std::
size_t
...
Ints
>
using index_sequence = std :: integer_sequence < std:: size_t , Ints... > ; |
||
Les alias templates auxiliaires
std::make_integer_sequence
et
std::make_index_sequence
sont définis pour simplifier la création des types
std::integer_sequence
et
std::index_sequence
respectivement, avec
0
,
1
,
2
,
...
,
N
-
1
comme
Ints
:
|
template
<
class
T, T N
>
using make_integer_sequence = std :: integer_sequence < T, /* une séquence 0, 1, 2, ..., N-1 */ > ; |
||
|
template
<
std::
size_t
N
>
using make_index_sequence = std :: make_integer_sequence < std:: size_t , N > ; |
||
Le programme est mal formé si
N
est négatif. Si
N
est zéro, le type indiqué est
integer_sequence<T>
.
Un alias template auxiliaire
std::index_sequence_for
est défini pour convertir n'importe quel pack de paramètres de type en une séquence d'indices de même longueur :
|
template
<
class
...
T
>
using index_sequence_for = std :: make_index_sequence < sizeof... ( T ) > ; |
||
Notes
| Macro de test de fonctionnalité | Valeur | Std | Fonctionnalité |
|---|---|---|---|
__cpp_lib_integer_sequence
|
201304L
|
(C++14) | Séquences d'entiers à la compilation |
Implémentation possible
| 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; |
Exemple
Voir aussi std::apply pour une autre implémentation possible à titre d'exemple.
#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... Est> void print_tuple_impl(std::basic_ostream<Ch, Tr>& os, const Tuple& t, std::index_sequence<Is...>) { ((os << (Is ? ", " : "") << std::obtenir<Is>(t)), ...); } } template <typename T, T... ints> void print_sequence(int id, std::integer_sequence<T, ints...> int_seq) { std::cout << id << ") La séquence de taille " << 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'; }
Sortie :
1) La séquence de taille 7 : 9 2 5 1 9 1 6 2) La séquence de taille 12 : 0 1 2 3 4 5 6 7 8 9 10 11 3) La séquence de taille 10 : 0 1 2 3 4 5 6 7 8 9 4) La séquence de taille 3 : 0 1 2 5) tuple1 : (1, 2, 3, 4) 6) tuple2 : (2, 1, 4, 3)
Voir aussi
|
(C++20)
|
crée un objet
std::array
à partir d'un tableau natif
(modèle de fonction) |
|
(C++11)
(C++17)
|
constante à la compilation du type spécifié avec la valeur spécifiée
(modèle de classe) |