Редактирование cpp/utility/integer sequence

Версия от 03:35, 15 ноября 2022; Olya (обсуждение | вклад)

(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

Предупреждение. Вы редактируете устаревшую версию данной страницы. После сохранения будут потеряны изменения, сделанные в последующих версиях.

Внимание! Вы не авторизовались на сайте.

В истории изменений этой страницы будет записан ваш IP-адрес.

{{cpp/title|integer_sequence}}
{{cpp/meta/navbar}}
{{ddcl | since=c++14 | header=utility | feature=__cpp_lib_integer_sequence | 1=
template< class T, T... Ints >
class integer_sequence;
}}

Шаблон класса {{tt|std::integer_sequence}} представляет последовательность целых чисел времени компиляции. При использовании в качестве аргумента [[cpp/language/function template|шаблона функции]] [[cpp/language/parameter pack|пакет параметров]] {{tt|Ints}} может быть выведен и использован в расширении пакета.

===Параметры шаблона===
{{par begin}}
{{par | T | целочисленный тип, используемый для элементов последовательности}}
{{par | ...Ints | пакет параметров не типов, представляющий последовательность}}
{{par end}}

===Типы элементов===
{{dsc begin}}
{{dsc hitem | Тип элемента | Определение}}
{{dsc | {{tt|value_type}} | {{tt|T}} }}
{{dsc end}}

===Функции-элементы===
{{dsc begin}}
{{dsc mem sfun | cpp/utility/integer_sequence | inlinemem=true | title=size | возвращает количество элементов в {{tt|Ints}}}}
{{dsc end}}

{{member | {{small|std::integer_sequence::}}size | 2=
{{ddcl | 1=
static constexpr std::size_t size() noexcept;
}}

Возвращает количество элементов в {{tt|Ints}}. Эквивалентно {{c|sizeof...(Ints)}}

===Параметры===
(нет)

===Возвращаемое значение===
Количество элементов в {{tt|Ints}}.

}}

===Вспомогательные шаблоны===

Псевдоним вспомогательного шаблона {{ttb|std::index_sequence}} определён для общего случая, когда {{tt|T}} равен {{lc|std::size_t}}:

{{ddcl | 1=
template<std::size_t... Ints>
using index_sequence = std::integer_sequence<std::size_t, Ints...>;
}}

Псевдонимы вспомогательных шаблонов {{ttb|std::make_integer_sequence}} и {{ttb|std::make_index_sequence}} определены для упрощения создания типов {{tt|std::integer_sequence}} и {{tt|std::index_sequence}} соответственно, с {{tt|Ints}} равным 0, 1, 2, ..., {{tt|N-1}}:

{{dcl begin}}
{{dcl | 1=
template<class T, T N>
using make_integer_sequence = std::integer_sequence<T, /* последовательность 0, 1, 2, ..., N-1 */ >;
}}
{{dcl | 1=
template<std::size_t N>
using make_index_sequence = std::make_integer_sequence<std::size_t, N>;
}}
{{dcl end}}

Программа некорректна, если {{tt|N}} отрицательное. Если {{tt|N}} равно нулю, указанный тип это {{tt|integer_sequence<T>}}.

Псевдоним вспомогательного шаблона {{ttb|std::index_sequence_for}} определён для преобразования любого пакета параметров типа в индексную последовательность той же длины:

{{dcl begin}}
{{dcl | 1=
template<class... T>
using index_sequence_for = std::make_index_sequence<sizeof...(T)>;
}}
{{dcl end}}

===Примечание===
{{feature test macro|__cpp_lib_integer_sequence}}

===Пример===
{{example|Примечание: другой пример смотрите в разделе ''Возможная реализация'' в {{rlpt|apply#Возможная реализация|std::apply}}.
|code=
#include <tuple>
#include <iostream>
#include <array>
#include <utility>

// средство отладки
template<typename T, T... ints>
void print_sequence(std::integer_sequence<T, ints...> int_seq)
{
    std::cout << "Последовательность размера " << int_seq.size() << ": ";
    ((std::cout << ints << ' '), ...);
    std::cout << '\n';
}

// преобразовывает массив в кортеж
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{});
}

// красивая печать кортежа
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};

// преобразование массива в кортеж
    auto tuple = a2t(array);
    static_assert(std::is_same_v<decltype(tuple),
                                 std::tuple<int, int, int, int>>, "");

// печать его в cout
    std::cout << "Кортеж: " << tuple << '\n';
}
|output=
Последовательность размера 7: 9 2 5 1 9 1 6 
Последовательность размера 20: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 
Последовательность размера 10: 0 1 2 3 4 5 6 7 8 9 
Последовательность размера 3: 0 1 2 
Кортеж: (1, 2, 3, 4)
}}

===Смотрите также===
{{dsc begin}}
{{dsc inc | cpp/container/array/dsc to_array}}
{{dsc end}}

Описание изменений:

Пожалуйста, учтите, что любой ваш вклад в проект «cppreference.com» может быть отредактирован или удалён другими участниками. Если вы не хотите, чтобы кто-либо изменял ваши тексты, не помещайте их сюда.
Вы также подтверждаете, что являетесь автором вносимых дополнений, или скопировали их из источника, допускающего свободное распространение и изменение своего содержимого (см. Cppreference:Авторские права). НЕ РАЗМЕЩАЙТЕ БЕЗ РАЗРЕШЕНИЯ ОХРАНЯЕМЫЕ АВТОРСКИМ ПРАВОМ МАТЕРИАЛЫ!

Отменить | Справка по редактированию (в новом окне)

Шаблоны, использованные на этой странице:

Источник — «https://ru.cppreference.com/w/cpp/utility/integer_sequence»

cppreference.com

Пространства имён

Варианты

Просмотры

Действия

Редактирование cpp/utility/integer sequence

Навигация

Инструменты