std:: integer_sequence
|
Определено в заголовке
<utility>
|
||
|
template
<
class
T, T...
Ints
>
class integer_sequence ; |
(начиная с C++14) | |
Шаблон класса
std::integer_sequence
представляет собой последовательность целых чисел, вычисляемую на этапе компиляции. При использовании в качестве аргумента для
шаблона функции
,
пакет параметров
Ints
может быть выведен и использован в раскрытии пакета.
Содержание |
Параметры шаблона
| T | - | целочисленный тип для элементов последовательности |
| ...Ints | - | пакет константных параметров, представляющий последовательность |
Типы членов
| Тип | Определение |
value_type
|
T
|
Функции-члены
|
size
[static]
|
возвращает количество элементов в
Ints
(публичная статическая функция-член) |
std::integer_sequence:: size
|
static
constexpr
std::
size_t
size
(
)
noexcept
;
|
||
Возвращает количество элементов в
Ints
. Эквивалентно
sizeof...
(
Ints
)
.
Возвращаемое значение
Количество элементов в
Ints
.
Вспомогательные шаблоны
Вспомогательный псевдоним шаблона
std::index_sequence
определён для распространённого случая, когда
T
является
std::size_t
:
|
template
<
std::
size_t
...
Ints
>
using index_sequence = std :: integer_sequence < std:: size_t , Ints... > ; |
||
Вспомогательные псевдонимы шаблонов
std::make_integer_sequence
и
std::make_index_sequence
определены для упрощения создания типов
std::integer_sequence
и
std::index_sequence
соответственно, с
0
,
1
,
2
,
...
,
N
-
1
в качестве
Ints
:
|
template
<
class
T, T N
>
using make_integer_sequence = std :: integer_sequence < T, /* последовательность 0, 1, 2, ..., N-1 */ > ; |
||
|
template
<
std::
size_t
N
>
using make_index_sequence = std :: make_integer_sequence < std:: size_t , N > ; |
||
Программа является некорректной, если
N
отрицательно. Если
N
равно нулю, указанный тип будет
integer_sequence<T>
.
Вспомогательный псевдоним шаблона
std::index_sequence_for
определён для преобразования любого пакета параметров типа в последовательность индексов той же длины:
|
template
<
class
...
T
>
using index_sequence_for = std :: make_index_sequence < sizeof... ( T ) > ; |
||
Примечания
| Макрос тестирования возможностей | Значение | Стандарт | Функция |
|---|---|---|---|
__cpp_lib_integer_sequence
|
201304L
|
(C++14) | Целочисленные последовательности времени компиляции |
Возможная реализация
| 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; |
Пример
Смотрите также std::apply возможную реализацию для другого примера.
#include <array> #include <cstddef> #include <iostream> #include <tuple> #include <utility> namespace details { template <typename Array, std::size_t... Я> 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... Is> 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 << ") Последовательность размера " << 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'; }
Вывод:
1) Последовательность размером 7: 9 2 5 1 9 1 6 2) Последовательность размером 12: 0 1 2 3 4 5 6 7 8 9 10 11 3) Последовательность размером 10: 0 1 2 3 4 5 6 7 8 9 4) Последовательность размером 3: 0 1 2 5) кортеж1: (1, 2, 3, 4) 6) кортеж2: (2, 1, 4, 3)
Смотрите также
|
(C++20)
|
создаёт объект
std::array
из встроенного массива
(шаблон функции) |
|
(C++11)
(C++17)
|
константа времени компиляции указанного типа с указанным значением
(шаблон класса) |