std::get(std::tuple)
From cppreference.com
template< std::size_t I, class... Types >
typename std::tuple_element<I, tuple<Types...> >::type& |
(1) | (since C++11) (until C++14) |
template< std::size_t I, class... Types >
constexpr std::tuple_element_t<I, tuple<Types...> >& |
(1) | (since C++14) |
template< std::size_t I, class... Types >
typename std::tuple_element<I, tuple<Types...> >::type&& |
(2) | (since C++11) (until C++14) |
template< std::size_t I, class... Types >
constexpr std::tuple_element_t<I, tuple<Types...> >&& |
(2) | (since C++14) |
template< std::size_t I, class... Types >
typename std::tuple_element<I, tuple<Types...> >::type const& |
(3) | (since C++11) (until C++14) |
template< std::size_t I, class... Types >
constexpr std::tuple_element_t<I, tuple<Types...> >const& |
(3) | (since C++14) |
template< class T, class... Types >
constexpr T& get(tuple<Types...>& t); |
(4) | (since C++14) |
template< class T, class... Types >
constexpr T&& get(tuple<Types...>&& t); |
(5) | (since C++14) |
template< class T, class... Types >
constexpr const T& get(const tuple<Types...>& t); |
(6) | (since C++14) |
1-3) Extracts the
Ith
element from the tuple. I
is an integer value in [0, sizeof...(Types))
.
4-6) Extracts the element of the tuple
t
whose type is T
. Fails to compile if the tuple has more than one element of that type.
Contents |
[edit] Parameters
t | - | tuple whose contents to extract |
[edit] Return value
1,4) Reference to the selected element of
t
.
2,5) Rvalue reference to the selected element of
t
, unless the element is of lvalue reference type, in which case lvalue reference is returned.
3,6) Const reference to the selected element of
t
.[edit] Exceptions
noexcept specification:
noexcept
[edit] Example
Run this code
#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 std::cout << "(" << std::get<int>(t) << ", " << std::get<const char*>(t) << ", " << std::get<double>(t) << ")\n"; }
Output:
(1, Foo, 3.14) (1, Foo, 3.14)
[edit] See also
accesses an element of an array (function template) |
|
(C++11)
|
accesses an element of a pair (function template) |