std:: integer_sequence
|
Definiert im Header
<utility>
|
||
|
template
<
class
T, T...
Ints
>
class integer_sequence ; |
(seit C++14) | |
Die Klassenvorlage
std::integer_sequence
repräsentiert eine Compile-Zeit-Sequenz von Ganzzahlen. Wenn sie als Argument für eine
Funktionsvorlage
verwendet wird, kann das
Parameterpaket
Ints
abgeleitet und in Paketentfaltung verwendet werden.
Inhaltsverzeichnis |
Template-Parameter
| T | - | ein Ganzzahltyp für die Elemente der Sequenz |
| ...Ints | - | ein konstantes Parameterpaket, das die Sequenz repräsentiert |
Mitgliedertypen
| Typ | Definition |
value_type
|
T
|
Memberfunktionen
|
size
[static]
|
gibt die Anzahl der Elemente in
Ints
zurück
(öffentliche statische Elementfunktion) |
std::integer_sequence:: size
|
static
constexpr
std::
size_t
size
(
)
noexcept
;
|
||
Gibt die Anzahl der Elemente in
Ints
zurück. Entspricht
sizeof...
(
Ints
)
.
Rückgabewert
Die Anzahl der Elemente in
Ints
.
Hilfsvorlagen
Eine Hilfs-Alias-Vorlage
std::index_sequence
ist für den häufigen Fall definiert, wo
T
std::size_t
ist:
|
template
<
std::
size_t
...
Ints
>
using index_sequence = std :: integer_sequence < std:: size_t , Ints... > ; |
||
Hilfs-Alias-Templates
std::make_integer_sequence
und
std::make_index_sequence
sind definiert, um die Erstellung von
std::integer_sequence
und
std::index_sequence
Typen zu vereinfachen, jeweils mit
0
,
1
,
2
,
...
,
N
-
1
als
Ints
:
|
template
<
class
T, T N
>
using make_integer_sequence = std :: integer_sequence < T, /* eine Sequenz 0, 1, 2, ..., N-1 */ > ; |
||
|
template
<
std::
size_t
N
>
using make_index_sequence = std :: make_integer_sequence < std:: size_t , N > ; |
||
Das Programm ist fehlerhaft, falls
N
negativ ist. Wenn
N
null ist, ist der angegebene Typ
integer_sequence<T>
.
Eine Hilfs-Alias-Vorlage
std::index_sequence_for
wird definiert, um jeden Typ-Parameterpaket in eine Indexsequenz gleicher Länge umzuwandeln:
|
template
<
class
...
T
>
using index_sequence_for = std :: make_index_sequence < sizeof... ( T ) > ; |
||
Hinweise
| Feature-Test Makro | Wert | Std | Feature |
|---|---|---|---|
__cpp_lib_integer_sequence
|
201304L
|
(C++14) | Kompilierzeit-Ganzzahlfolgen |
Mögliche Implementierung
| 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; |
Beispiel
Siehe auch std::apply mögliche Implementierung für ein weiteres Beispiel.
#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... Ist> 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 << ") Die Sequenz der Größe " << 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'; }
Ausgabe:
1) Die Sequenz der Größe 7: 9 2 5 1 9 1 6 2) Die Sequenz der Größe 12: 0 1 2 3 4 5 6 7 8 9 10 11 3) Die Sequenz der Größe 10: 0 1 2 3 4 5 6 7 8 9 4) Die Sequenz der Größe 3: 0 1 2 5) Tupel1: (1, 2, 3, 4) 6) Tupel2: (2, 1, 4, 3)
Siehe auch
|
(C++20)
|
erstellt ein
std::array
Objekt aus einem eingebauten Array
(Funktions-Template) |
|
(C++11)
(C++17)
|
Compile-Time-Konstante des angegebenen Typs mit angegebenem Wert
(Klassen-Template) |