unordered_map::emplace
Wstawia element skonstruowany w miejscu (nie wykonano żadnej czynności kopiowania ani przenoszenia) do unordered_map.
template<class... Args>
pair<iterator, bool> emplace(
Args&&... args);
Parametry
Parametr |
Opis |
args |
Argumenty przekazywane do konstruowania elementu do wstawienia do unordered_map, chyba że zawiera ona już element, którego wartość jest równoważnie uporządkowana. |
Wartość zwracana
pair, której składnik bool zwraca true jeśli wystąpiło wstawienie i false, jeśli unordered_map zawiera już element, którego klucz ma równoważną wartość w szeregowaniu i którego składnik iterator zwraca adres, na który wstawiono nowy element lub gdzie element już się znajdował.
Aby uzyskać dostęp do składnika iteratora pary pr, zwracanej przez tę funkcję członkowską, użyj pr.first i aby usunąć odwołanie, użyj *(pr.first).Aby uzyskać dostęp do składnika bool pary pr, zwróconej przez tę funkcję członkowską, użyj pr.second.
Uwagi
Żadne iteratory ani 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.
Dla przykładu kodu zobacz map::emplace.
Wymagania
Nagłówek: <unordered_map>
Przestrzeń nazw: std