Sdílet prostřednictvím


pair – struktura

Struktura, která poskytuje možnost pracovat se dvěma objekty jako jeden objekt.

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
      );
   };

Parametry

  • _Val1
    Hodnota inicializace první element pair.

  • _Val2
    Hodnota inicializace druhého prvku pair.

  • _Right
    Dvojice, jejichž hodnoty mají být použity k inicializaci prvky jiný pár.

Vrácená hodnota

První (výchozí) konstruktor inicializuje první prvek dvojice výchozí typ Type1 a druhý prvek výchozí typ typ2.

Druhý konstruktor inicializuje první prvek této dvojici _Val1 a druhý na _Val2.

Třetí (šablona) konstruktor inicializuje první prvek této dvojici _Right. první a druhý na _Right.second.

Čtvrtý konstruktor inicializuje první prvek této dvojici _Val1 a druhý na _Val2 pomocí Deklarátor odkazu hodnoty R: &&.

Poznámky

Struktura šablony ukládá dvojice objektů typu Type1 a typ2, respektive.Typ first_type je stejný jako parametr šablony Type1 a typ second_type je stejný jako parametr šablony typ2.Typ1 a typ2 každý potřebovat zadat výchozí konstruktor, jediným argumentem konstruktoru a destruktoru.Všechny členy typu pair jsou veřejné, protože je typ deklarován jako struct , spíše než jako třídy.Jako návratové typy pro funkce, které vracejí dvě hodnoty a jako prvky pro kontejner asociativní třídy jsou dva nejčastější použití pro dvojici mapování třídy a multimap třídy které mají klíče a typu hodnoty přiřazené ke každému elementu.Splňuje požadavky pro pár asociativní kontejner a má hodnotu typu formuláře pair<bkey_type, mapped_type>. 

Příklad

// 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;
   }
}
  

Požadavky

Záhlaví:<nástroje>

Obor názvů: std

Viz také

Referenční dokumentace

Pair – logický operátor

Bezpečný přístup z více vláken ve standardní knihovně C++