Partager via


définissez : : insertion (STL/CLR)

Ajoute les éléments.

    cliext::pair<iterator, bool> insert(value_type val);
    iterator insert(iterator where, value_type val);
    template<typename InIter>
        void insert(InIter first, InIter last);
    void insert(System::Collections::Generic::IEnumerable<value_type>^ right);

Paramètres

  • first
    Début de la plage à insérer.

  • last
    Fin de la plage à insérer.

  • right
    Énumération à insérer.

  • val
    Valeur clé à insérer.

  • where
    Où insérer dans le conteneur (indice uniquement).

Notes

Chacune des fonctions membres insère une séquence spécifiée par les opérandes restants.

La première fonction membre essaie d'insérer un élément avec la valeur val, et retourne une paire de valeurs X. Si X.second a la valeur true, X.first désigne l'élément nouvellement inséré ; dans le cas contraire, X.first désigne un élément avec un classement équivalent qui existe déjà et aucun nouvel élément n'est inséré. Vous l'utilisez pour insérer un élément.

La deuxième fonction membre insère un élément avec la valeur val, utilisant where comme indicateur (pour améliorer les performances), et retourne un itérateur qui indique l'élément nouvellement inséré. Vous l'utilisez pour insérer un élément unique qui peut être en regard de l'élément que vous connaissez.

La troisième méthode insère la séquence [first, last). Vous l'utilisez pour insérer zéro ou plusieurs éléments copiés à partir d'une autre séquence.

La quatrième méthode insère la séquence indiquée par right. Vous l'utilisez pour insérer une séquence décrite par un énumérateur.

Chaque insertion d'élément prend un temps proportionnel au logarithme du nombre d'éléments dans la séquence contrôlée. L'insertion peut se produire en temps fixe amorti, toutefois, selon un indicateur qui indique un élément en regard du point d'insertion.

Exemple

// cliext_set_insert.cpp 
// compile with: /clr 
#include <cliext/set> 
 
typedef cliext::set<wchar_t> Myset; 
typedef Myset::pair_iter_bool Pairib; 
int main() 
    { 
    Myset c1; 
    c1.insert(L'a'); 
    c1.insert(L'b'); 
    c1.insert(L'c'); 
 
// display initial contents " a b c" 
    for each (wchar_t elem in c1) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
 
// insert a single value, unique and duplicate 
    Pairib pair1 = c1.insert(L'x'); 
    System::Console::WriteLine("insert(L'x') = [{0} {1}]", 
        *pair1.first, pair1.second); 
 
    pair1 = c1.insert(L'b'); 
    System::Console::WriteLine("insert(L'b') = [{0} {1}]", 
        *pair1.first, pair1.second); 
 
    for each (wchar_t elem in c1) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
 
// insert a single value with hint 
    System::Console::WriteLine("insert(begin(), L'y') = {0}", 
        *c1.insert(c1.begin(), L'y')); 
    for each (wchar_t elem in c1) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
 
// insert an iterator range 
    Myset c2; 
    Myset::iterator it = c1.end(); 
    c2.insert(c1.begin(), --it); 
    for each (wchar_t elem in c2) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
 
// insert an enumeration 
    Myset c3; 
    c3.insert(   // NOTE: cast is not needed 
        (System::Collections::Generic::IEnumerable<wchar_t>^)%c1); 
    for each (wchar_t elem in c3) 
        System::Console::Write(" {0}", elem); 
    System::Console::WriteLine(); 
    return (0); 
    } 
 
  

Configuration requise

En-tête : <cliext/set>

Espace de noms cliext

Voir aussi

Référence

set (STL/CLR)