Estrutura pair
Uma estrutura que prevê a capacidade de controlar 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 outros pares.
Valor de retorno
O primeiro construtor (padrão) inicializa o primeiro elemento do par da opção de tipo Type1 e o segundo elemento para a opção de tipo Type2.
O segundo construtor inicializa o primeiro elemento do par a _Val1 e a segunda _Val2.
O terceiro construtor de modelo () inicializa o primeiro elemento do par a _Right.first e a segunda _Right.second.
O quarto construtor inicializa o primeiro elemento do par a _Val1 e a segunda _Val2 usando Declarador de referência Rvalue: &&.
Comentários
O struct do modelo armazena um par de objetos do tipo Type1 e Type2, respectivamente. O tipo first_type é o mesmo que o parâmetro Type1 do modelo e o tipo second_type é o mesmo que o parâmetro Type2do modelo. Type1 e Type2 cada necessidade fornecem apenas um construtor padrão, um construtor de um único argumento, e um destruidor. Todos os membros do tipo pair são públicos, como o tipo é declarado como struct em vez de como class. Dois a maioria dos usos comuns para um par são os tipos de retorno para funções que retornam dois valores e como os elementos do contêiner associativo classe a classe do mapa e classe de multimap que têm uma chave e um tipo de valor associado a cada elemento. O último satisfaz os requisitos para um contêiner associativo de pares e tem um tipo de valor do formulário pair<const key_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
utilitário <deCabeçalho: >
Namespace: std