unordered_map::emplace_hint
Wstawia element skonstruowany w miejscu (bez wykonania żadnej czynności kopiowania ani przenoszenia) ze wskazówką położenia.
template<class... Args>
iterator emplace_hint(
const_iterator where,
Args&&... args);
Parametry
Parametr |
Opis |
args |
Argumenty przekazywane do konstruowania elementu do wstawienia do unordered_map, chyba że unordered_map 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 dotycząca miejsca rozpoczęcia wyszukiwania dla poprawnego punktu wstawiania. |
Wartość zwracana
Iterator do nowo wstawionego elementu.
Jeśli wstawianie się nie powiodło, ponieważ element już istnieje, zwraca iterator do istniejącego elementu.
Uwagi
Żadne odwołania nie są unieważniane przez tę funkcję.
Podczas wstawiania, jeśli zgłoszono wyjątek, lecz nie występuje on w funkcji skrótu kontenera, kontener nie jest modyfikowany.Jeśli wyjątek jest zgłoszony w funkcji skrótu, wynik jest niezdefiniowany.
value_type elementu jest parą, dzięki czemu wartość elementu będzie uporządkowaną parą z pierwszym składnikiem równym wartości klucza i drugim składnikiem równym wartości danych elementu.
Dla przykładu kodu zobacz map::emplace_hint.
Wymagania
Nagłówek: <unordered_map>
Przestrzeń nazw: std