map::find
Devuelve un iterador que dirige la ubicación de un elemento en un mapa que tiene un equivalente key en una clave especificada.
iterator find(
const Key& _Key
);
const_iterator find(
const Key& _Key
) const;
Parámetros
- _Key
El valor de clave que se va a comparar por el criterio de ordenación de un elemento de mapa que se busca.
Valor devuelto
Un iterador que dirige la ubicación de un elemento con una clave especificada, o la ubicación que funciona correctamente el último elemento del mapa si no se encuentra ninguna coincidencia para la clave.
Comentarios
La función miembro devuelve un iterador que dirige un elemento en la asignación cuyo criterio de ordenación es equivalente a la clave del argumento en predicado binario que induzca orden basado en menos que la relación de la comparabilidad.
Si el valor devuelto de búsqueda se asigna a const_iterator, el objeto map no puede modificarse.Si el valor devuelto de búsqueda se asigna a iterador, el objeto map puede modificarse
Ejemplo
// map_find.cpp
// compile with: /EHsc
#include <map>
#include <iostream>
int main( )
{
using namespace std;
map <int, int> m1;
map <int, int> :: const_iterator m1_AcIter, m1_RcIter;
typedef pair <int, int> Int_Pair;
m1.insert ( Int_Pair ( 1, 10 ) );
m1.insert ( Int_Pair ( 2, 20 ) );
m1.insert ( Int_Pair ( 3, 30 ) );
m1_RcIter = m1.find( 2 );
cout << "The element of map m1 with a key of 2 is: "
<< m1_RcIter -> second << "." << endl;
// If no match is found for the key, end( ) is returned
m1_RcIter = m1.find( 4 );
if ( m1_RcIter == m1.end( ) )
cout << "The map m1 doesn't have an element "
<< "with a key of 4." << endl;
else
cout << "The element of map m1 with a key of 4 is: "
<< m1_RcIter -> second << "." << endl;
// The element at a specific location in the map can be found
// using a dereferenced iterator addressing the location
m1_AcIter = m1.end( );
m1_AcIter--;
m1_RcIter = m1.find( m1_AcIter -> first );
cout << "The element of m1 with a key matching "
<< "that of the last element is: "
<< m1_RcIter -> second << "." << endl;
}
Requisitos
encabezado: <Asignar>
espacio de nombres: std