std::get(std::tuple)

From cppreference.com
template< std::size_t I, class... Types >

typename std::tuple_element<I, tuple<Types...> >::type&

    get( tuple<Types...>& t );
(1) (since C++11)
template< std::size_t I, class... Types >

typename std::tuple_element<I, tuple<Types...> >::type&&

    get( tuple<Types...>&& t );
(2) (since C++11)
template< std::size_t I, class... Types >

typename std::tuple_element<I, tuple<Types...> >::type const&

    get( const tuple<Types...>& t );
(3) (since C++11)

Extracts the Ith element element from the tuple. I is an integer value in [0, sizeof...(Types)).

Contents

[edit] Parameters

t - tuple whose contents to extract

[edit] Return value

1) Reference to the Ith element of t.

2) Rvalue reference to the Ith element of t, unless the element is of lvalue reference type, in which case lvalue reference is returned.

3) Const reference to the Ith element of t.

[edit] Exceptions

noexcept specification:  
noexcept
  (since C++11)

[edit] Example

#include <iostream>
#include <string>
#include <tuple>
 
int main()
{
    auto t = std::make_tuple(1, "Foo", 3.14);
    std::cout << "(" << std::get<0>(t) << ", " << std::get<1>(t)
              << ", " << std::get<2>(t) << ")\n";
}

Output:

(1, Foo, 3.14)

[edit] See also

accesses an element of an array
(function template)
accesses an element of a pair
(function template)