std:: make_pair
| 
           Defined in header
            
            
             <utility>
            
            | ||
| 
           
            
             template
            
            
             <
            
            
             class
            
            T1,
            
             class
            
            T2
            
             >
            
             std:: pair < T1, T2 > make_pair ( T1 x, T2 y ) ; | (until C++11) | |
| 
           
            
             template
            
            
             <
            
            
             class
            
            T1,
            
             class
            
            T2
            
             >
            
             std:: pair < /*V1*/ , /*V2*/ > make_pair ( T1 && x, T2 && y ) ; | (since C++11) (constexpr since C++14) (until C++20) | |
| 
           
            
             template
            
            
             <
            
            
             class
            
            T1,
            
             class
            
            T2
            
             >
            
             
             
              constexpr
             
             
              
               std::
               
                pair
               
              
             
             
              <
             
             
              
               std::
               
                unwrap_ref_decay_t
               
              
             
             
              <
             
             T1
             
              >
             
             ,
              | (since C++20) | |
Creates a std::pair object, deducing the target type from the types of arguments.
| 
          Given types
          
           
            
             std::
             
              decay
             
            
           
           
            <
           
           T1
           
            >
           
           
            ::
           
           
            type
           
          
          as
           
 | (since C++11) (until C++20) | 
Parameters
| x, y | - | the values to construct the pair from | 
Return value
| std:: pair < T1, T2 > ( x, y ) | (until C++11) | 
| std:: pair < /*V1*/ , /*V2*/ > ( std:: forward < T1 > ( x ) , std:: forward < T2 > ( y ) ) | (since C++11) (until C++20) | 
| 
          
           
            
             
              std::
              
               pair
              
             
            
            
             <
            
            
             
              std::
              
               unwrap_ref_decay_t
              
             
            
            
             <
            
            T1
            
             >
            
            ,
            
             
              std::
              
               unwrap_ref_decay_t
              
             
            
            
             <
            
            T2
            
             >>
            
           
            | (since C++20) | 
Example
#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"; }
Output:
The value of p1 is (1, 2) The value of p2 is (7, 3)
Defect reports
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior | 
|---|---|---|---|
| LWG 181 | C++98 | the parameter types were const-reference types, which made passing arrays impossible | changed these types to value types |