std::flat_multiset<Key,Compare,KeyContainer>::emplace
template< class... Args > iterator emplace( Args&&... args ); | (начиная с C++23) |
Вставляет в контейнер новый элемент, конструируемый на месте с заданными args.
Сначала инициализирует объект t типа value_type с помощью std::forward<Args>(args)..., затем вставляет t так, как если бы была вызвана
auto it = ranges::upper_bound(c, t, compare); c.insert(it, std::move(t));
Эта перегрузка участвует в разрешении перегрузки только если std::is_constructible_v<value_type, Args...> является true.
Аккуратное использование emplace позволяет сконструировать новый элемент, избегая ненужных операций копирования или перемещения.
Параметры
| args | - | аргументы, передаваемые конструктору элемента |
Возвращаемое значение
Итератор на вставленный элемент.
Исключения
Если по какой-либо причине выбрасывается исключение, эта функция не оказывает никакого эффекта (строгая гарантия безопасности при исключениях).
Сложность
Логарифмическая относительно размера контейнера.
Пример
См. также
| конструирует элементы на месте, используя подсказку (открытая функция-член) |
|
| вставляет элементы (открытая функция-член) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/flat_multiset/emplace