hash_multimap::insert
[!UWAGA]
Ten interfejs API jest nieaktualny.Alternatywą jest unordered_multimap — Klasa.
Wstawia element lub zakres elementów do hash_multimap.
iterator insert(
const value_type& Val
);
iterator insert(
const_iterator Where,
const value_type& Val
);
void insert(
initializer_list<value_type> IList
);
template<class InputIterator>
void insert(
InputIterator First,
InputIterator Last
);
template<class ValTy>
iterator insert(
ValTy&& Val
);
template<class ValTy>
iterator insert(
const_iterator Where,
ValTy&& Val
);
Parametry
Parametr |
Opis |
Val |
Wartość elementu, która ma zostać wstawiona do hash_multimap, chyba że ta już zawiera ten element lub bardziej ogólnie, chyba że już zawiera element którego klucz jest równoważnie uporządkowany. |
Where |
Wskazówka o tym, gdzie zacząć wyszukiwanie dla poprawnego punktu wstawiania. |
First |
Pozycja pierwszego elementu, który ma zostać skopiowany mapy. |
Last |
Pozycja tuż po ostatnim elemencie, który ma zostać skopiowany z mapy. |
Wartość zwracana
Pierwsze dwie funkcje członkowskie insert zwracają iterator, który wskazuje miejsce, gdzie został wstawiony nowy element.
Trzecia funkcja członkowska używa initializer_list dla elementów do wstawienia.
Czwarta funkcja członkowska wstawia sekwencję wartości elementu do mapy, która odpowiada każdemu elementowi zaadresowanemu przez iterator w zakresie [First, Last) z określonego zestawu.
Ostatnie dwie funkcje członkowskie insert zachowują się tak samo jak pierwsze dwie, chyba że przenoszą przenoszą-tworzą wstawianą wartość.
Uwagi
value_type elementu jest parą, dzięki czemu wartość elementu będzie uporządkowaną parą, w której pierwszy składnik jest równy wartości klucza, a drugi składnik równy wartości danych elementu.
Wstawienia w wersji insert ze wskazówką, mogą wystąpić w stałym, amortyzowanym czasie, zamiast czasu logarytmicznego, jeśli punkt wstawienia bezpośrednio poprzedza Where.
Wymagania
Nagłówek: <hash_map>
Przestrzeń nazw: stdext