unordered_multiset::insert

ajoute des éléments.

iterator insert(const value_type& val);
iterator insert(iterator where, const value_type& val);
template<class InIt>
    void insert(InIt first, InIt last);
template<class ValTy>
    iterator insert(ValTy&& val);
template<class ValTy>
    iterator insert(const_iterator where, ValTy&& val);

Paramètres

Notes

La première fonction membre insère l'élément val dans la séquence contrôlée, puis retourne l'itérateur qui indique que l'élément inséré.La deuxième fonction membre retourne insert(val), à l'aide de where comme point de départ dans la séquence contrôlée pour rechercher le point d'insertion.(L'insertion peut éventuellement se produire en un peu plus rapidement, si le point d'insertion immédiatement précède ou suit where.)

la troisième fonction membre insère la séquence de valeurs d'élément, pour chaque where dans la plage [first, last), en appelant insert(*where).

Les deux dernières fonctions membres se comportent de la même manière que les deux premiers, sauf qu' val est utilisé pour construire la valeur insérée.

Si une exception est levée pendant la mise en place d'un seul élément, le conteneur reste inchangé et l'exception est à nouveau levée.Si une exception est levée pendant la mise en place de plusieurs éléments, le conteneur est laissé dans un stable mais l'état non spécifiée et l'exception est à nouveau levée.

Exemple

// std_tr1__unordered_set__unordered_multiset_insert.cpp 
// compile with: /EHsc 
#include <unordered_set> 
#include <iostream>
#include <string> 
 
typedef std::unordered_multiset<char> Myset; 
int main() 
    { 
    Myset c1; 
 
    c1.insert('a'); 
    c1.insert('b'); 
    c1.insert('c'); 
 
// display contents " [c] [b] [a]" 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// insert with hint and reinspect 
    Myset::iterator it2 = c1.insert(c1.begin(), 'd'); 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// insert range and inspect 
    Myset c2; 
 
    c2.insert(c1.begin(), c1.end()); 
    for (Myset::const_iterator it = c2.begin(); 
        it != c2.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// insert new and duplicate, and reinspect 
    c1.insert('e'); 
    c1.insert('a'); 
    for (Myset::const_iterator it = c1.begin(); 
        it != c1.end(); ++it) 
        std::cout << " [" << *it << "]"; 
    std::cout << std::endl; 
 
// The templatized versions move constructing elements
    unordered_multiset< string> c3, c4;
    string str1("a"), str2("b");

    c3.insert(move(is1));
    cout << "After the move insertion, c3 contains: "
        << *c3.begin() << endl;

    c4.insert(c4.begin(), move(is2));
    cout << "After the move insertion, c4 contains: "
        << *c4.begin() << endl;

    return (0); 
    } 
 

Configuration requise

en-tête : <unordered_set>

l'espace de noms : type

Voir aussi

Référence

<unordered_set>

unordered_multiset Class

Autres ressources

<unordered_set> membres