Заголовочный файл стандартной библиотеки <tuple> (C++11)

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Заголовочные файлы стандартной библиотеки

Языковая поддержка
<cstddef> <cstdlib> <version>(C++20) <limits> <climits>	<cfloat> <cstdint>(C++11) <stdfloat>(C++23) <new> <typeinfo>	<source_location>(C++20) <exception> <initializer_list>(C++11) <compare>(C++20)	<coroutine>(C++20) <csignal> <csetjmp> <cstdarg>
Концепты
<concepts>(C++20)
Диагностика
<stdexcept> <stacktrace>(C++23)	<cassert>	<cerrno>	<system_error>(C++11)
Управление памятью
<memory>	<memory_resource>(C++17)	<scoped_allocator>(C++11)
Метапрограммирование
<type_traits>(C++11)	<ratio>(C++11)
Общие утилиты
<utility> <tuple>(C++11) <optional>(C++17) <variant>(C++17)	<any>(C++17) <expected>(C++23) <bitset>	<functional> <typeindex>(C++11) <execution>(C++17)	<charconv>(C++17) <format>(C++20) <bit>(C++20)
Строки
<string_view>(C++17) <string>	<cctype> <cwctype>	<cstring> <cwchar>	<cuchar>(C++11)
Контейнеры
<array>(C++11) <deque> <forward_list>(C++11) <list>	<vector> <map> <set> <unordered_map>(C++11)	<unordered_set>(C++11) <queue> <stack> <flat_map>(C++23)	<flat_set>(C++23) <span>(C++20) <mdspan>(C++23)
Итераторы
<iterator>
Диапазоны
<ranges>(C++20)	<generator>(C++23)
Алгоритмы
<algorithm>	<numeric>
Числа
<cfenv>(C++11) <complex>	<random>(C++11) <valarray>	<cmath>	<numbers>(C++20)
Время
<chrono>(C++11)	<ctime>
Локализация
<locale>	<clocale>	<codecvt>(C++11/17*)
Ввод/вывод
<iosfwd> <iostream> <ios> <streambuf>	<istream> <ostream> <iomanip> <print>(C++23)	<sstream> <spanstream>(C++23) <fstream> <syncstream>(C++20)	<filesystem>(C++17) <cstdio> <cinttypes>(C++11) <strstream>(C++98*)
Регулярные выражения
<regex>(C++11)
Поддержка конкуренции
<stop_token>(C++20) <thread>(C++11) <atomic>(C++11)	<stdatomic.h>(C++23) <mutex>(C++11) <shared_mutex>(C++14)	<condition_variable>(C++11)   <semaphore>(C++20) <latch>(C++20)	<barrier>(C++20) <future>(C++11)
Совместимость с C
<cstdbool>(C++11/17/20*)   <ccomplex>(C++11/17/20*)	<ctgmath>(C++11/17/20*)	<cstdalign>(C++11/17/20*)	<ciso646>(до C++20)

 

Этот заголовок является частью библиотеки общих утилит.

Включает
<compare> (C++20)	Поддержка оператора трёхстороннего сравнения
Классы
tuple (C++11)	реализует контейнер фиксированного размера, который содержит элементы, возможно, разных типов (шаблон класса)
tuple_size (C++11)	получает количество элементов tuple подобного типа (шаблон класса)
tuple_element (C++11)	получает типы элементов tuple подобного типа (шаблон класса)
std::tuple_size<std::tuple> (C++11)	получает размер tuple во время компиляции (специализация шаблона класса)
std::tuple_element<std::tuple> (C++11)	получает тип указанного элемента (специализация шаблона класса)
std::uses_allocator<std::tuple> (C++11)	специализация свойств типа std::uses_allocator (специализация шаблона класса)
Константы
ignore (C++11)	заполнитель для пропуска элемента при распаковке tuple с помощью tie (константа)
Функции
make_tuple (C++11)	создаёт объект tuple типа, определённого типами аргументов (шаблон функции)
tie	создаёт tuple левосторонних ссылок или распаковывает кортеж на отдельные объекты (шаблон функции)
forward_as_tuple (C++11)	создаёт tupleпересылалаемых ссылок (шаблон функции)
tuple_cat (C++11)	создаёт tuple, объединяя любое количество кортежей (шаблон функции)
std::get(std::tuple) (C++11)	доступ к определённому элементу кортежа (шаблон функции)
operator==operator!=operator<operator<=operator>operator>=operator<=> (удалено в C++20)(удалено в C++20)(удалено в C++20)(удалено в C++20)(удалено в C++20)(C++20)	лексикографически сравнивает значения в кортеже (шаблон функции)
std::swap(std::tuple) (C++11)	специализация алгоритма std::swap (шаблон функции)
apply (C++17)	вызывает функцию с кортежем аргументов (шаблон функции)
make_from_tuple (C++17)	создаёт объект с кортежем аргументов (шаблон функции)

Краткое описание

#include <compare>   namespace std {// шаблонный класс tupletemplate<class... Types>class tuple;   // функции создания tupleinlineconstexpr/* не определено */ ignore;   template<class... TTypes>constexpr tuple<unwrap_ref_decay_t<TTypes>...> make_tuple(TTypes&&...);   template<class... TTypes>constexpr tuple<TTypes&&...> forward_as_tuple(TTypes&&...)noexcept;   template<class... TTypes>constexpr tuple<TTypes&...> tie(TTypes&...)noexcept;   template<class... Tuples>constexpr tuple<CTypes...> tuple_cat(Tuples&&...);   // вызов функции с tuple в качестве аргументовtemplate<class F, class Tuple>constexpr decltype(auto) apply(F&& f, Tuple&& t);   template<class T, class Tuple>constexpr T make_from_tuple(Tuple&& t);   // вспомогательные классы для tupletemplate<class T>struct tuple_size;// не определеноtemplate<class T>struct tuple_size<const T>;   template<class... Types>struct tuple_size<tuple<Types...>>;   template<size_t I, class T>struct tuple_element;// не определеноtemplate<size_t I, class T>struct tuple_element<I, const T>;   template<size_t I, class... Types>struct tuple_element<I, tuple<Types...>>;   template<size_t I, class T>using tuple_element_t =typename tuple_element<I, T>::type;   // доступ к элементамtemplate<size_t I, class... Types>constexpr tuple_element_t<I, tuple<Types...>>& get(tuple<Types...>&)noexcept;template<size_t I, class... Types>constexpr tuple_element_t<I, tuple<Types...>>&& get(tuple<Types...>&&)noexcept;template<size_t I, class... Types>constexprconst tuple_element_t<I, tuple<Types...>>& get(const tuple<Types...>&)noexcept;template<size_t I, class... Types>constexprconst tuple_element_t<I, tuple<Types...>>&& get(const tuple<Types...>&&)noexcept;template<class T, class... Types>constexpr T& get(tuple<Types...>& t)noexcept;template<class T, class... Types>constexpr T&& get(tuple<Types...>&& t)noexcept;template<class T, class... Types>constexprconst T& get(const tuple<Types...>& t)noexcept;template<class T, class... Types>constexprconst T&& get(const tuple<Types...>&& t)noexcept;   // операторы отношенияtemplate<class... TTypes, class... UTypes>constexprbool operator==(const tuple<TTypes...>&, const tuple<UTypes...>&);template<class... TTypes, class... UTypes>constexpr common_comparison_category_t</*synth-three-way-result*/<TTypes, UTypes>...> operator<=>(const tuple<TTypes...>&, const tuple<UTypes...>&);   // свойства, связанные с аллокаторомtemplate<class... Types, class Alloc>struct uses_allocator<tuple<Types...>, Alloc>;   // специализированные алгоритмыtemplate<class... Types>constexprvoid swap(tuple<Types...>& x, tuple<Types...>& y)noexcept(/* смотрите описание */);   // вспомогательные классы для tupletemplate<class T>inlineconstexpr size_t tuple_size_v = tuple_size<T>::value;}   // устарелоnamespace std {template<class T>class tuple_size<volatile T>;template<class T>class tuple_size<constvolatile T>;   template<size_t I, class T>class tuple_element<I, volatile T>;template<size_t I, class T>class tuple_element<I, constvolatile T>;}

Шаблонный класс std::tuple

namespace std {template<class... Types>class tuple {public:// создание tupleconstexprexplicit(/* смотрите описание */) tuple();constexprexplicit(/* смотрите описание */) tuple(const Types&...);// только если sizeof...(Types) >= 1template<class... UTypes>constexprexplicit(/* смотрите описание */) tuple(UTypes&&...);// только если sizeof...(Types) >= 1   tuple(const tuple&)=default; tuple(tuple&&)=default;   template<class... UTypes>constexprexplicit(/* смотрите описание */) tuple(const tuple<UTypes...>&);template<class... UTypes>constexprexplicit(/* смотрите описание */) tuple(tuple<UTypes...>&&);   template<class U1, class U2>constexprexplicit(/* смотрите описание */) tuple(const pair<U1, U2>&);// только если sizeof...(Types) == 2template<class U1, class U2>constexprexplicit(/* смотрите описание */) tuple(pair<U1, U2>&&);// только если sizeof...(Types) == 2   // конструкторы, расширенные аллокаторомtemplate<class Alloc>constexprexplicit(/* смотрите описание */) tuple(allocator_arg_t, const Alloc& a);template<class Alloc>constexprexplicit(/* смотрите описание */) tuple(allocator_arg_t, const Alloc& a, const Types&...);template<class Alloc, class... UTypes>constexprexplicit(/* смотрите описание */) tuple(allocator_arg_t, const Alloc& a, UTypes&&...);template<class Alloc>constexpr tuple(allocator_arg_t, const Alloc& a, const tuple&);template<class Alloc>constexpr tuple(allocator_arg_t, const Alloc& a, tuple&&);template<class Alloc, class... UTypes>constexprexplicit(/* смотрите описание */) tuple(allocator_arg_t, const Alloc& a, const tuple<UTypes...>&);template<class Alloc, class... UTypes>constexprexplicit(/* смотрите описание */) tuple(allocator_arg_t, const Alloc& a, tuple<UTypes...>&&);template<class Alloc, class U1, class U2>constexprexplicit(/* смотрите описание */) tuple(allocator_arg_t, const Alloc& a, const pair<U1, U2>&);template<class Alloc, class U1, class U2>constexprexplicit(/* смотрите описание */) tuple(allocator_arg_t, const Alloc& a, pair<U1, U2>&&);   // присваивание tupleconstexpr tuple& operator=(const tuple&);constexpr tuple& operator=(tuple&&)noexcept(/* смотрите описание */);   template<class... UTypes>constexpr tuple& operator=(const tuple<UTypes...>&);template<class... UTypes>constexpr tuple& operator=(tuple<UTypes...>&&);   template<class U1, class U2>constexpr tuple& operator=(const pair<U1, U2>&);// только если sizeof...(Types) == 2template<class U1, class U2>constexpr tuple& operator=(pair<U1, U2>&&);// только если sizeof...(Types) == 2   // обмен tupleconstexprvoid swap(tuple&)noexcept(/* смотрите описание */);};   template<class... UTypes> tuple(UTypes...)-> tuple<UTypes...>;template<class T1, class T2> tuple(pair<T1, T2>)-> tuple<T1, T2>;template<class Alloc, class... UTypes> tuple(allocator_arg_t, Alloc, UTypes...)-> tuple<UTypes...>;template<class Alloc, class T1, class T2> tuple(allocator_arg_t, Alloc, pair<T1, T2>)-> tuple<T1, T2>;template<class Alloc, class... UTypes> tuple(allocator_arg_t, Alloc, tuple<UTypes...>)-> tuple<UTypes...>;}