Compartilhar via


pair Structure

Uma estrutura que prever a capacidade de lidar com dois objetos como um único objeto.

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

Parâmetros

  • _Val1
    Valor que inicializa o primeiro elemento de pair.

  • _Val2
    Valor que inicializa o segundo elemento de pair.

  • _Right
    Um par cujos valores devem ser usada para inicializar os elementos de um outros pares.

Valor de retorno

O primeiro construtor (padrão) inicializa o primeiro elemento de pares a opção de tipo Type1 e o segundo elemento à opção de tipo Type2.

O segundo construtor inicializa o primeiro elemento de pares a _Val1 e da _Val2.

O terceiro construtor (modelo) inicializa o primeiro elemento de pares a _Right.first e da _Right.second.

O quarto construtor inicializa o primeiro elemento de pares a _Val1 e da _Val2 usando Declarador de referência Rvalue: & &.

Comentários

A estrutura do modelo armazena um par de objetos do tipo Type1 e Type2, respectivamente.O tipo first_type é o mesmo como o parâmetro Type1 de modelo e o tipo second_type são o mesmo que o parâmetro Type2do modelo.Type1 e Type2 cada necessidade fornecem apenas um construtor padrão, um único argumento do construtor, e um destrutor.Todos os membros do tipo pair são públicos, porque o tipo é declarado como struct em vez de como classe.Dois para os usos mais comuns para um par são como tipos de retorno para as funções que retornam dois valores e como elementos para o contêiner associativo classe classe de mapa e classe de multimap que têm uma chave e um tipo de valor associados a cada elemento.O último satisfaz os requisitos para um contêiner associativo de pares e tem um tipo de valor de formulário pair<constkey_type, mapped_type>.

Exemplo

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

Requisitos

Cabeçalho: <utility>

namespace: STD

Consulte também

Referência

Pair Logical Operator

Segurança do thread na biblioteca C++ padrão