std::multimap::emplace
Z cppreference.com
template< class... Args > iterator emplace( Args&&... args ); |
(od C++11) | |
Wstawia nowy element do kontenera, konstruowany "w miejscu"(ang) z argumentami args przekazanymi do konstruktora .
Ostrożne wykorzystanie emplace pozwala uniknąć niepotrzebnych operacji kopiowania/przenoszenia.
Konstruktor nowego elementu (tj. std::pair<const Key, T>) jest wywołany z dokładnie tymi samymi argumentami, z którymi zostało wywołane emplace, przekazanymi poprzez std::forward<Args>(args)....
Żadne iteratory ani referencje nie zostają unieważnione.
Parametry
| args | - | argumenty do przekazania do konstruktora elementu |
Zwracana wartość
Zwraca iterator na wstawiony element.
Wyjątki
Jeśli zostanie wyrzucony wyjątek przez jakąkolwiek operację, ta funkcja nie ma żadnego efektu.
Złożoność
Logarytmiczna względem rozmiaru kontenera.
Przykład
#include <iostream>
#include <utility>
#include <string>
#include <map>
int main()
{
std::multimap<std::string, std::string> m;
// uses pair's move constructor
m.emplace(std::make_pair(std::string("a"), std::string("a")));
// uses pair's converting move constructor
m.emplace(std::make_pair("b", "abcd"));
// uses pair's template constructor
m.emplace("d", "ddd");
// uses pair's piecewise constructor
m.emplace(std::piecewise_construct,
std::forward_as_tuple("c"),
std::forward_as_tuple(10, 'c'));
for (const auto &p : m) {
std::cout << p.first << " => " << p.second << '\n';
}
}
Wynik:
a => a
b => abcd
c => cccccccccc
d => ddd
Zobacz także
(C++11) |
tworzy elementy "w miejscu", korzystając z podpowiedzi (publiczna metoda) |
| wstawia elementy (publiczna metoda) |