mappage multiple : : 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 clé à rechercher.

Notes

La fonction membre détermine le dernier élément X dans la séquence contrôlée dont le classement est équivalent à key. Si cet élément n'existe pas, ou si X est le dernier éléments de la séquence contrôlée, cela retourne mappage multiple : : fin (STL/CLR)(); sinon cela renvoie un itérateur qui indique le premier élément au delà de X. Vous l'utilisez pour rechercher le la fin d'une séquence d'éléments figurant actuellement dans la séquence contrôlée qui correspondent à la clé spécifiée.

Exemple

// cliext_multimap_upper_bound.cpp 
// compile with: /clr 
#include <cliext/map> 
 
typedef cliext::multimap<wchar_t, int> Mymultimap; 
int main() 
    { 
    Mymultimap c1; 
    c1.insert(Mymultimap::make_value(L'a', 1)); 
    c1.insert(Mymultimap::make_value(L'b', 2)); 
    c1.insert(Mymultimap::make_value(L'c', 3)); 
 
// display contents " [a 1] [b 2] [c 3]" 
    for each (Mymultimap::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()); 
 
    Mymultimap::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); 
    }