std::make_pair

Определён в заголовочном файле <utility>

Определён в заголовочном файле `<utility>`
template< class T1, class T2 > std::pair<T1, T2> make_pair( T1 x, T2 y );		(до C++11)
template< class T1, class T2 > std::pair</V1/, /V2/> make_pair( T1&& x, T2&& y );		(начиная с C++11) (до C++20) (constexpr начиная с C++14)
template< class T1, class T2 > constexpr std::pair<std::unwrap_ref_decay_t<T1>, std::unwrap_ref_decay_t<T2>> make_pair( T1&& x, T2&& y );		(начиная с C++20)

template< class T1, class T2 >
std::pair<T1, T2> make_pair( T1 x, T2 y );

(до C++11)

template< class T1, class T2 >
std::pair</*V1*/, /*V2*/> make_pair( T1&& x, T2&& y );

(начиная с C++11)
(до C++20)
(constexpr начиная с C++14)

template< class T1, class T2 >
constexpr std::pair<std::unwrap_ref_decay_t<T1>,
                    std::unwrap_ref_decay_t<T2>>
    make_pair( T1&& x, T2&& y );

(начиная с C++20)

Создаёт объект std::pair, выводя целевой тип из типов аргументов.

Для типов std::decay<T1>::type в качестве U1 и std::decay<T2>::type в качестве U2 типы /*V1*/ и /*V2*/ определяются следующим образом:

Если U1 — это std::reference_wrapper<X>, /*V1*/ — это X&; в противном случае /*V1*/ — это U1.
Если U2 — это std::reference_wrapper<Y>, /*V2*/ — это Y&; в противном случае /*V2*/ — это U2.

(начиная с C++11)
(до C++20)

Параметры

x, y

значения, из которых создаётся пара

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

`std::pair<T1, T2>(x, y)`	(до C++11)
`std::pair</V1/, /V2/>(std::forward<T1>(x), std::forward<T2>(y))`	(начиная с C++11) (до C++20)
`std::pair<std::unwrap_ref_decay_t<T1>, std::unwrap_ref_decay_t<T2>>(std::forward<T1>(x), std::forward<T2>(y))`	(начиная с C++20)

Пример

#include <functional>
#include <iostream>
#include <utility>

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 + 2) << ")\n";
}

Вывод:

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

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

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

DR	Применяется к	Опубликованное поведение	Правильное поведение
LWG 181	C++98	типы параметров были типами константных ссылок , что делало невозможной передачу массивов	эти типы были заменены типами-значениями

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