std::multiset<Key,Compare,Allocator>:: emplace
|
template
<
class
...
Args
>
iterator emplace ( Args && ... args ) ; |
(начиная с C++11)
(constexpr начиная с C++26) |
|
Вставляет новый элемент в контейнер, созданный на месте с заданными args .
Конструктор нового элемента вызывается с точно такими же аргументами, которые были переданы в
emplace
, проброшенными через
std::
forward
<
Args
>
(
args
)
...
.
Если
value_type
не является
EmplaceConstructible
в
multiset
из
args
, поведение не определено.
Никакие итераторы или ссылки не инвалидируются.
Содержание |
Параметры
| args | - | аргументы для передачи конструктору элемента |
Возвращаемое значение
Итератор на вставленный элемент.
Исключения
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).
Сложность
Логарифмическая от размера контейнера.
Примечания
Аккуратное использование
emplace
позволяет создавать новый элемент, избегая ненужных операций копирования или перемещения.
Пример
#include <chrono> #include <cstddef> #include <functional> #include <iomanip> #include <iostream> #include <string> #include <set> class Dew { private: int a, b, c; public: Dew(int _a, int _b, int _c) : a(_a), b(_b), c(_c) {} bool operator<(const Dew& other) const { return (a < other.a) || (a == other.a && b < other.b) || (a == other.a && b == other.b && c < other.c); } }; constexpr int nof_operations{101}; std::size_t set_emplace() { std::multiset<Dew> set; for (int i = 0; i < nof_operations; ++i) for (int j = 0; j < nof_operations; ++j) for (int k = 0; k < nof_operations; ++k) set.emplace(i, j, k); return set.size(); } std::size_t set_insert() { std::multiset<Dew> set; for (int i = 0; i < nof_operations; ++i) for (int j = 0; j < nof_operations; ++j) for (int k = 0; k < nof_operations; ++k) set.insert(Dew(i, j, k)); return set.size(); } void time_it(std::function<int()> set_test, std::string what = "") { const auto start = std::chrono::system_clock::now(); const auto the_size = set_test(); const auto stop = std::chrono::system_clock::now(); const std::chrono::duration<double, std::milli> time = stop - start; if (!what.empty() && the_size) std::cout << std::fixed << std::setprecision(2) << time << " для " << what << '\n'; } int main() { time_it(set_insert, "прогрев кэша..."); time_it(set_insert, "insert"); time_it(set_insert, "insert"); time_it(set_emplace, "emplace"); time_it(set_emplace, "emplace"); }
Возможный вывод:
499.61ms для cache warming... 447.89ms для insert 436.77ms для insert 430.62ms для emplace 428.61ms для emplace
Смотрите также
|
(C++11)
|
создаёт элементы на месте с использованием подсказки
(публичная функция-член) |
|
вставляет элементы
или узлы
(начиная с C++17)
(публичная функция-член) |