pair Structure

可讓您將兩個物件視為單一物件的結構。

template<class Type1, class Type2>
   struct pair 
   {
   typedef Type1 first_type;
   typedef Type2 second_type;
   Type1 first;
   Type2 second;
   pair( );
   pair(
      const Type1& __Val1, 
      const Type2& __Val2
   );
   template<class Other1, class Other2>
      pair(
         const pair<Other1, Other2>& _Right
      );
   template<class Other1, class Other2>
      pair(
         Other1&& _Val1, Other2&& _Val2
      );
   };

參數

• _Val1
  初始化 pair的第一個項目的值。

• _Val2
  初始化 pair的第二個項目的值。

• _Right
  要用來初始化另一組項目的一個名稱/值組。

傳回值

第一個 (預設) 建構函式初始化字組中的第一個項目至型別 Type1 預設和第二個項目為型別 Type2預設值。

第二個建構函式會對的第一個項目。 _Val1 和秒為 _Val2。

第三個 (範本) 建構函式初始化字組中的第一個項目。 _Right。first 和秒為 _Right。second。

使用 右值參考的宣告子: & &，第四個建構函式會對的第一個項目。 _Val1 和秒為 _Val2 。

備註

範本結構儲存一組型別 Type1 和 Type2物件，分別。這個型別 first_type 是當做樣板參數 Type1 和型別 second_type 與樣板參數 Type2一樣。Type1 和 Type2 每個需要提供一個預設的建構函式、單一引數建構函式和只能有一個解構函式。，因為這個型別宣告為 struct 而不是 class，型別 pair 的所有成員都是公用的。一組的兩種最常見的用途是為傳回兩個值之函式的傳回型別，以及使用時，如果有一個索引鍵和一個實值型別與每個項目結合容器中的項目將 對應類別 和 multimap 類別 。後者滿足結合容器的需求和表單 pair<constkey_type， mapped_type的>實值型別 (Value Type)。

範例

// utility_pair.cpp
// compile with: /EHsc
#include <utility>
#include <map>
#include <iomanip>
#include <iostream>

int main( )
{
   using namespace std;

   // Using the constructor to declare and initialize a pair
   pair <int, double> p1 ( 10, 1.1e-2 );

   // Compare using the helper function to declare and initialize a pair
   pair <int, double> p2;
   p2 = make_pair ( 10, 2.22e-1 );

   // Making a copy of a pair
   pair <int, double> p3 ( p1 );

   cout.precision ( 3 );
   cout << "The pair p1 is: ( " << p1.first << ", " 
        << p1.second << " )." << endl;
   cout << "The pair p2 is: ( " << p2.first << ", " 
        << p2.second << " )." << endl;
   cout << "The pair p3 is: ( " << p3.first << ", " 
        << p3.second << " )." << endl;

   // Using a pair for a map element
   map <int, int> m1;
   map <int, int>::iterator m1_Iter;

   typedef pair <int, int> Map_Int_Pair;

   m1.insert ( Map_Int_Pair ( 1, 10 ) );
   m1.insert ( Map_Int_Pair ( 2, 20 ) );
   m1.insert ( Map_Int_Pair ( 3, 30 ) );

   cout << "The element pairs of the map m1 are:";
   for ( m1_Iter = m1.begin( ); m1_Iter != m1.end( ); m1_Iter++ )
      cout << " ( " << m1_Iter -> first << ", "
           << m1_Iter -> second << " )";
   cout   << "." << endl;

   // Using pair as a return type for a function
   pair< map<int,int>::iterator, bool > pr1, pr2;
   pr1 = m1.insert ( Map_Int_Pair ( 4, 40 ) );
   pr2 = m1.insert ( Map_Int_Pair (1, 10 ) );

   if( pr1.second == true )
   {
      cout << "The element (4,40) was inserted successfully in m1."
           << endl;
   }
   else   
   {
      cout << "The element with a key value of\n"
           << " ( (pr1.first) -> first ) = " << ( pr1.first ) -> first 
           << " is already in m1,\n so the insertion failed." << endl;
   }

   if( pr2.second == true )
   {
      cout << "The element (1,10) was inserted successfully in m1."
           << endl;
   }
   else   
   {
      cout << "The element with a key value of\n"
           << " ( (pr2.first) -> first ) = " << ( pr2.first ) -> first 
           << " is already in m1,\n so the insertion failed." << endl;
   }
}

需求

標題: <utility>

命名空間: std

請參閱

參考

Pair Logical Operator

在標準 C++ 程式庫中的執行緒安全