hash_multimap : : upper_bound (STL/CLR)

Article
06/10/2015

Recherche la fin de la plage qui correspond à une clé spécifiée.

    iterator upper_bound(key_type key);

Paramètres

key
Valeur de clé à rechercher.

Notes

La méthode détermine le dernier élément X de la séquence contrôlée qui est haché dans le même compartiment que key et qui a un classement équivalent à key. Si aucun élément de ce type n'existe, ou si X est le dernier élément de la séquence contrôlée, cela retourne hash_multimap : : fin (STL/CLR)(); sinon cela renvoie un itérateur qui indique le premier élément au delà de X. Vous l'utilisez pour rechercher la fin d'une séquence d'éléments figurant actuellement dans la séquence contrôlée qui correspond à la clé spécifiée.

Exemple

// cliext_hash_multimap_upper_bound.cpp 
// compile with: /clr 
#include <cliext/hash_map> 
 
typedef cliext::hash_multimap<wchar_t, int> Myhash_multimap; 
int main() 
    { 
    Myhash_multimap c1; 
    c1.insert(Myhash_multimap::make_value(L'a', 1)); 
    c1.insert(Myhash_multimap::make_value(L'b', 2)); 
    c1.insert(Myhash_multimap::make_value(L'c', 3)); 
 
// display contents " [a 1] [b 2] [c 3]" 
    for each (Myhash_multimap::value_type elem in c1) 
        System::Console::Write(" [{0} {1}]", elem->first, elem->second); 
    System::Console::WriteLine(); 
 
    System::Console::WriteLine("upper_bound(L'x')==end() = {0}", 
        c1.upper_bound(L'x') == c1.end()); 
 
    Myhash_multimap::iterator it = c1.upper_bound(L'a'); 
    System::Console::WriteLine("*upper_bound(L'a') = [{0} {1}]", 
        it->first, it->second); 
    it = c1.upper_bound(L'b'); 
    System::Console::WriteLine("*upper_bound(L'b') = [{0} {1}]", 
        it->first, it->second); 
    return (0); 
    }