unordered_multiset::insert

Статья
02/20/2013

Добавляет элементы.

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);

Параметры

Параметр	Описание
InIt	Тип итератора.
ValTy	Тип аргумента конструктора на месте.
first	Начало диапазона, который необходимо вставить.
last	Элемент диапазона, который необходимо вставить.
val	Значение для вставки.
where	, Где в контейнере вставки (подсказка).

Заметки

Первый функцию-член вставляет элемент val в управляемой последовательности, затем возвращает итератор, который задает вставленный элемент.Возвращает второй функция-член insert(val), использование where как начальное место в пределах управляемой последовательности, в которых выполняется поиск точки вставки.По возможности (insert может возникнуть несколько быстрее, если точка вставки непосредственно предшествует или после where.)

Третий функцию-член вставляет последовательность значений, для каждого элемента where в диапазоне [first, last)вызов insert(*where).

Последние 2 функции-члена ведут себя так же, как и первые 2, за исключением того, что val используется для построения вставляемое значение.

Если исключение возникает во время вставки одного элемента, то контейнер, остаются без изменений и исключение вызывается заново.Если исключение возникает во время вставки нескольких элементов, то контейнер остается в стабилизированном но неопределенное состояние и исключение вызывается заново.

Пример

// 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); 
    }

Требования

заголовок:<unordered_set>

пространство имен: STD

См. также

Ссылки

<unordered_set>

unordered_multiset Class

Другие ресурсы

члены<unordered_set>

Поделиться через