unordered_multiset::insert
Wstawia element lub zakres elementów do unordered_multiset.
// (1) single element pair<iterator, bool> insert( const value_type& Val ); // (2) single element, perfect forwarded template<class ValTy> pair<iterator, bool> insert( ValTy&& Val ); // (3) single element with hint iterator insert( const_iterator Where, const value_type& Val ); // (4) single element, perfect forwarded, with hint template<class ValTy> iterator insert( const_iterator Where, ValTy&& Val ); // (5) range template<class InputIterator> void insert( InputIterator First, InputIterator Last ); // (6) initializer list void insert( initializer_list<value_type> IList );
Parametry
Parametr |
Opis |
Val |
Wartość elementu ma zostać wstawiony do unordered_multiset. |
Where |
Miejsce, aby rozpocząć wyszukiwanie poprawne punkt wstawienia. |
ValTy |
Parametr szablonu, który określa typ argumentu, który unordered_multiset służy do konstruowania elementu value_typei doskonałą przodu Val jako argumentu. |
First |
Pozycja pierwszego elementu do skopiowania. |
Last |
Pozycja poza ostatni element do skopiowania. |
InputIterator |
Argument funkcji szablonu, który spełnia wymagania input sterująca wskazujące elementy typu, który może służyć do konstruowania value_type obiektów. |
IList |
Initializer_list z której mają być kopiowane elementy. |
Wartość zwracana
Funkcje pojedynczym — element — Wstaw element członkowski [1] i [2], zwracają iterację do lokalizacji, w której wstawieniu do unordered_multiset nowego elementu.
Funkcje elementu członkowskiego pojedynczego elementu z wskazówkę, [3] i [4], zwracać iterację wskazujące położenie, gdzie nowego elementu wstawiono do unordered_multiset.
Uwagi
Nie wskaźników lub odwołuje się do unieważnienie tej funkcji, ale może powodować, Iteratory wszystkich do kontenera.
Podczas wstawiania tylko jednego elementu jeśli wyjątek zgłaszany, ale nie występuje w kontenerze funkcji skrótu, stan kontenera nie jest modyfikowany.Jeśli wyjątek zgłaszany w funkcji skrótu, wynikiem jest niezdefiniowana.Podczas wstawiania wiele elementów jeśli wyjątek kontenera pozostanie nieokreślony, ale nieprawidłowy stan.
Value_type kontenera jest typedef, którego należy do kontenera, a dla zestawu, unordered_multiset<V>::value_type jest typem const V.
Funkcja elementu członkowskiego zakresu [5] wstawia sekwencję wartości elementów do unordered_multiset umożliwiająca każdy element zlikwidowane poprzez iterację w zakresie [First, Last); w związku z tym Last nie uzyskać wstawiony.Funkcja elementu członkowskiego kontenera end() odwołuje się do pozycji po ostatnim elemencie w kontenerze — na przykład instrukcji m.insert(v.begin(), v.end()); wstawia wszystkie elementy v do m.
(6) jest używana funkcja inicjatora członka listy initializer_list skopiować elementy do unordered_multiset.
Do wstawienia elementu skonstruowane w miejscu, oznacza to, że są wykonywane żadnych operacji kopiowania i przenoszenia — zobacz unordered_multiset::emplace i unordered_multiset::emplace_hint.
Aby uzyskać przykład kodu, zobacz multiset::insert.
Wymagania
Nagłówek: < unordered_set >
Przestrzeń nazw: std