std::tuple

 

C++

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

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

Язык

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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

Языковая поддержка Поддержка типов (базовые типы, RTTI) Макросы тестирования функциональности библиотеки (C++20) Управление динамической памятью launder (C++17) Программные утилиты Поддержка сопрограмм (C++20) Вариативные функции is_constant_evaluated (C++20) initializer_list (C++11) source_location (C++20) Трёхстороннее сравнение (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)    is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

Общие утилиты Дата и время Функциональные объекты Библиотека форматирования (C++20) bitset hash (C++11) Операторы отношения (устарело в C++20) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= Целочисленные функции сравнения cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)    cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Операции обмена и типа swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Общие лексические типы pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) Элементарные преобразования строк to_chars (C++17) from_chars (C++17) chars_format (C++17)

 

std::tuple

Функции-члены

tuple::tuple

tuple::operator=

tuple::swap

Функции, не являющиеся членами

make_tuple

tie

forward_as_tuple

None

operator=operator!=operator<operator<=operator>operator>=

std::swap

get

Вспомогательные классы Оригинал: Helper classes Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

tuple_size

tuple_element

uses_allocator

ignore

 

Определено в заголовочном файле <tuple>
template< class... Типы > class tuple;		(начиная с C++11)

Шаблон класса std::tuple представляет собой фиксированного размера набор разнородных значений. Это обобщение std::pair.

Если std::is_trivially_destructible<Ti>::value равно true для каждого Ti в Типы, деструктор tuple тривиален.

Параметры шаблона

Типы...

—

типы элементов, которые хранятся в кортеже. Поддерживается пустой список.

Функции элементы

(конструктор)	создаёт новый tuple (public функция-элемент)
operator=	присваивает содержимое одного tuple другому (public функция-элемент)
swap	меняет местами содержимое двух tuple местами (public функция-элемент)

Функции, не являющиеся элементами

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 (шаблон функции)

Вспомогательные классы

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 (специализация шаблона класса)
std::basic_common_reference<std::tuple> (C++23)	определяет общий ссылочный тип двух tuple и tuple подобного типов (специализация шаблона класса)
std::common_type<tuple-подобный> (C++23)	определяет общий тип tuple и tuple подобного типа (специализация шаблона класса)
ignore (C++11)	заполнитель для пропуска элемента при распаковке tuple с помощью tie (константа)

Примечание

До N4387 (применяемого как отчёт о дефектах для C++11), функция не могла вернуть кортеж, используя копирование-списка-инициализации:

std::tuple<int, int> foo_tuple() 
{
  return {1, -1};  // Ошибка до N4387
  return std::tuple<int, int>{1, -1}; // Всегда работает
  return std::make_tuple(1, -1); // Всегда работает
}

Пример

Запустить этот код

#include <tuple>
#include <iostream>
#include <string>
#include <stdexcept>
 
std::tuple<double, char, std::string> get_student(int id)
{
    if (id == 0) return std::make_tuple(3.8, 'A', "Лиза Симпсон");
    if (id == 1) return std::make_tuple(2.9, 'C', "Милхаус Ван Хаутен");
    if (id == 2) return std::make_tuple(1.7, 'D', "Ральф Виггам");
    throw std::invalid_argument("id");
}
 
int main()
{
    auto student0 = get_student(0);
    std::cout << "ИД: 0, "
              << "Средний балл: " << std::get<0>(student0) << ", "
              << "категория: " << std::get<1>(student0) << ", "
              << "имя: " << std::get<2>(student0) << '\n';
 
    double gpa1;
    char grade1;
    std::string name1;
    std::tie(gpa1, grade1, name1) = get_student(1);
    std::cout << "ИД: 1, "
              << "Средний балл: " << gpa1 << ", "
              << "категория: " << grade1 << ", "
              << "имя: " << name1 << '\n';
 
    // Структурная привязка C++17:
    auto [ gpa2, grade2, name2 ] = get_student(2);
    std::cout << "ИД: 2, "
              << "Средний балл: " << gpa2 << ", "
              << "категория: " << grade2 << ", "
              << "имя: " << name2 << '\n';
}

Вывод:

ИД: 0, Средний балл: 3.8, категория: A, имя: Лиза Симпсон
ИД: 1, Средний балл: 2.9, категория: C, имя: Милхаус Ван Хаутен
ИД: 2, Средний балл: 1.7, категория: D, имя: Ральф Виггам

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 2796	C++11	тривиальность деструктора tuple не определена	определена

Ссылки

• C++23 стандарт (ISO/IEC 14882:2023):

• 22.4 Кортежи [tuple]

• C++20 стандарт (ISO/IEC 14882:2020):

• 20.5 Кортежи [tuple]

• C++17 стандарт (ISO/IEC 14882:2017):

• 23.5 Кортежи [tuple]

• C++14 стандарт (ISO/IEC 14882:2014):

• 20.4 Кортежи [tuple]

• C++11 стандарт (ISO/IEC 14882:2011):

• 20.4 Кортежи [tuple]

Смотрите также

pair	реализует двойной кортеж, т.е. пару значений (шаблон класса)