Libreria mappe C ++ - funzione equal_range ()

Descrizione

La funzione C ++ std::multimap::equal_range() restituisce un intervallo di elementi che corrisponde a una chiave specifica.

L'intervallo è definito da due iteratori, uno punta al primo elemento che non è inferiore alla chiave k e un altro punta al primo elemento maggiore della chiave k .

Dichiarazione

Di seguito è la dichiarazione per std :: multimap :: equal_range () modulo std :: map header.

C ++ 98

pair<const_iterator,const_iterator> equal_range (const key_type& k) const;
pair<iterator,iterator>             equal_range (const key_type& k);

Parametri

k - Chiave da cercare.

Valore di ritorno

Se l'oggetto è qualificato costante, il metodo restituisce una coppia di iteratori costanti, altrimenti una coppia di iteratori non costanti.

Eccezioni

Nessun effetto sul contenitore se viene generata un'eccezione.

Complessità temporale

Logaritmico ie O (log n)

Esempio

L'esempio seguente mostra l'utilizzo della funzione std :: multimap :: equal_range ().

#include <iostream>
#include <map>

using namespace std;

int main(void) {
   multimap<char, int> m = {
      {'a', 1},
      {'b', 2},
      {'b', 3},
      {'b', 4},
      {'d', 5}
        };

   auto ret = m.equal_range('b');

   cout << "Elements associated with key 'b': ";

   for (auto it = ret.first; it != ret.second; ++it)
      cout << it->second << " ";
   cout << endl;

   return 0;
}

Compiliamo ed eseguiamo il programma sopra, questo produrrà il seguente risultato:

Elements associated with key 'b': 2 3 4