std::get(std::tuple)

From Cppreference

Jump to: navigation, search
template< std::size_t I, class... Types >

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

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

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

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

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

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

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

  (C++11 feature)

[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