std::make_pair

 

C++

Language

Concepts

Utilities library

Strings library

Containers library

Algorithms library

Iterators library

Numerics library

Input/output library

Localizations library

Regular expressions library (C++11)

Atomic operations library (C++11)

Thread support library (C++11)

 

Utilities library

Type support (basic types, RTTI, type traits)

Dynamic memory management

Error handling

Program utilities

Variadic functions

Date and time

Function objects

initializer_list (C++11)

bitset

hash (C++11)

Relational operators

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

Pairs and tuples

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

Swap, forward and move

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

std::pair

Member functions

pair::pair

pair::operator=

pair::swap

Non-member functions

make_pair

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

std::swap

get (C++11)

Helper classes

tuple_size (C++11)

tuple_element (C++11)

 

Defined in header <utility>
template< class T1, class T2 > std::pair<T1,T2> make_pair( T1 t, T2 u ); template< class T1, class T2 > std::pair<V1,V2> make_pair( T1&& t, T2&& u );		(until C++11) (since C++11)

Creates a std::pair object, deducing the target type from the types of arguments.

The deduced types are std::decay<T1>::type and std::decay<T2>::type (the usual type transformations applied to arguments of functions passed by value) unless application of std::decay results in std::reference_wrapper<X> for some type X, in which case the deduced type is is X&. (since C++11)

Parameters

t, u

-

the values to construct the pair from

Return value

an std::pair object containing the given values.

Example

#include <iostream>
#include <utility>
#include <functional>
int main()
{
    int n = 1;
    int a[5] = {1,2,3,4,5};
 
    // build a pair from two ints
    auto p1 = std::make_pair(n, a[1]);
    std::cout << "The value of p1 is "
              << "(" << p1.first << ", " << p1.second << ")\n";
 
    // build a pair from a reference to int and an array (decayed to pointer)
    auto p2 = std::make_pair(std::ref(n), a);
    n = 7;
    std::cout << "The value of p2 is "
              << "(" << p2.first << ", " << *(p2.second+1) << ")\n";
}

Output:

The value of p1 is (1, 2)
The value of p2 is (7, 2)