std::get(std::tuple)

Определено в заголовке `<tuple>`
template< std::size_t I, class... Types > typename std::tuple_element<I, tuple<Types...> >::type& get( tuple<Types...>& t ) noexcept;	(1)	(с C++11) (constexpr с C++14)
template< std::size_t I, class... Types > typename std::tuple_element<I, tuple<Types...> >::type&& get( tuple<Types...>&& t ) noexcept;	(2)	(с C++11) (constexpr с C++14)
template< std::size_t I, class... Types > typename std::tuple_element<I, tuple<Types...> >::type const& get( const tuple<Types...>& t ) noexcept;	(3)	(с C++11) (constexpr с C++14)
template< std::size_t I, class... Types > typename std::tuple_element<I, tuple<Types...> >::type const&& get( const tuple<Types...>&& t ) noexcept;	(4)	(с C++11) (constexpr с C++14)
template< class T, class... Types > constexpr T& get( tuple<Types...>& t ) noexcept;	(5)	(с C++14)
template< class T, class... Types > constexpr T&& get( tuple<Types...>&& t ) noexcept;	(6)	(с C++14)
template< class T, class... Types > constexpr const T& get( const tuple<Types...>& t ) noexcept;	(7)	(с C++14)
template< class T, class... Types > constexpr const T&& get( const tuple<Types...>&& t ) noexcept;	(8)	(с C++14)

1-4) Извлекает I-й элемент из кортежа. I должно быть целым значением в [0, sizeof...(Types)).

5-8) Извлекает элемент кортежа t с типом T. Не компилируется, если кортеж не содержит ровно один элемент этого типа.

Параметры

кортеж, из которого нужно извлечь содержимое

Возвращаемое значение

Ссылка на выбранный элемент t.

Примечания

Макросы проверки наличия функций	Значение	Std	Функция
`__cpp_lib_tuples_by_type`	201304L	(C++14)	Обращение к кортежам по типу

Пример

#include <iostream>
#include <string>
#include <tuple>
 
int main()
{
    auto t = std::make_tuple(1, "Foo", 3.14);
 
    // Index-based access
    std::cout << "( " << std::get<0>(t)
              << ", " << std::get<1>(t)
              << ", " << std::get<2>(t)
              << " )\n";
 
    // Type-based access (C++14 or later)
    std::cout << "( " << std::get<int>(t)
              << ", " << std::get<const char*>(t)
              << ", " << std::get<double>(t)
              << " )\n";
 
    // Note: std::tie and structured binding may also be used to decompose a tuple.
}

Вывод:

( 1, Foo, 3.14 )
( 1, Foo, 3.14 )

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применено к	Поведение, как опубликовано	Правильное поведение
LWG 2485	C++11 (по индексу) C++14 (по типу)	нет перегрузок для const tuple&&	перегрузки добавлены

См. также

Структурированные привязки (C++17)	связывает указанные имена с подобъектами или элементами кортежа инициализатора
get(std::array) (C++11)	обращение к элементу `array` (шаблон функции)
get(std::pair) (C++11)	обращение к элементу пары (шаблон функции)
get(std::variant) (C++17)	считывает значение варианта, заданного по индексу или типу (если тип уникален), выбрасывает ошибку при ошибке (шаблон функции)
get(std::ranges::subrange) (C++20)	получение итератора или стоп-значения из `std::ranges::subrange` (шаблон функции)
get(std::complex) (C++26)	получение ссылки на действительную или мнимую часть `std::complex` (шаблон функции)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/utility/tuple/get