std::map<Key,T,Compare,Allocator>::emplace

template< class... Args >
std::pair<iterator, bool> emplace( Args&&... args );

Вставляет новый элемент в контейнер, созданный на месте с заданными args, если в контейнере нет элемента с таким ключом.

Аккуратное использование emplace позволяет создать новый элемент, избегая ненужных копирований или перемещений. Конструктор нового элемента (т.е. std::pair<const Key, T>) вызывается с точно такими же аргументами, что и предоставленными emplace, переданными через std::forward<Args>(args).... Элемент может быть создан даже если в контейнере уже есть элемент с таким же ключом, в этом случае недавно созданный элемент будет немедленно уничтожен.

Ни один итератор или ссылка не становятся недействительными.

Параметры

Возвращаемое значение

Возвращает пару, состоящую из итератора на вставленный элемент или уже существующий элемент, если вставка не произошла, и bool, указывающего, произошла ли вставка (true, если вставка произошла, false, если нет).

Исключения

Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта (гарантия устойчивости к исключениям).

Сложность

Логарифмическая по размеру контейнера.

Пример

#include <iostream>
#include <string>
#include <map>
#include <utility>
 
int main()
{
    std::map<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'));
    // as of C++17, m.try_emplace("c", 10, 'c'); can be used
 
    for (const auto& p : m)
        std::cout << p.first << " => " << p.second << '\n';
}

a => a
b => abcd
c => cccccccccc
d => ddd

См. также