CKTIS / C++
std::vector::emplace_back — конструиране на елемент в края на вектор
Конструира един елемент в края на вектора от подадените аргументи. Вижте какво връща функцията и кога съществуващите референции стават невалидни.
Версия: ISO C++23; implementation support may vary
Синтаксис
#include <vector>
// Member declaration inside std::vector<T, Allocator> (C++23):
template<class... Args>
constexpr reference emplace_back(Args&&... args);
// Call on a vector v:
v.emplace_back(args...);std::vector::emplace_back от заглавния файл <vector> добавя един елемент в края на вектора и при успех увеличава size() с едно. Параметрите Args&&... са препращащи референции: std::forward запазва разграничението между lvalue и rvalue, но препраща prvalue като xvalue. В основния шаблон елементът от тип T се конструира направо в паметта на вектора чрез извикване на std::allocator_traits<Allocator>::construct с препратените аргументи. T трябва да отговаря на изискването EmplaceConstructible за тези аргументи и на MoveInsertable за този вектор дори при достатъчен капацитет. Специализацията std::vector<bool> не е длъжна да използва allocator_traits::construct за конструиране на стойностите си.
emplace_back може да използва конструктор explicit, без извикващият код да създава временен обект T. Ако вече разполагате с T, push_back ясно изразява намерението за копиране (const T&) или за подаване за преместване (T&&). Конструирането на място не гарантира липса на копиране или преместване. В C++11 и C++14 функцията връща void, а от C++17 връща reference към новия елемент (T& в основния шаблон, прокси обект в std::vector<bool>). От C++20 функцията е constexpr, като важат правилата за константно изчисляване.
Добавянето в края отнема амортизирано константно време; при преразпределяне на паметта времето е линейно спрямо броя на елементите. Ако новият размер надхвърли предишния capacity(), преразпределянето прави невалидни всички досегашни указатели, референции и итератори към елементи, както и стария end(). Без преразпределяне става невалиден само старият end(). Успешно извикване на reserve(n) осигурява капацитет поне n, но не променя size() и не създава елементи.
Ако вмъкването хвърли изключение, векторът обикновено остава непроменен. Ако обаче изключението идва от преместващия конструктор на тип T, който не отговаря на CopyInsertable за този вектор, ефектите не са уточнени от стандарта. Не достъпвайте елементи чрез невалидни референции или указатели.
Примери
#include <iostream>
#include <string>
#include <utility>
#include <vector>
struct Result {
std::string name;
int score;
explicit Result(std::string n, int s) : name(std::move(n)), score(s) {}
};
int main() {
std::vector<Result> results;
results.reserve(2);
std::cout << "size after reserve: " << results.size() << '\n';
auto& first = results.emplace_back("Ada", 40);
results.emplace_back("Lin", 35);
first.score += 2;
std::cout << "size after insertion: " << results.size() << '\n';
for (const auto& result : results) {
std::cout << result.name << ": " << result.score << '\n';
}
}
Резултат
size after reserve: 0 size after insertion: 2 Ada: 42 Lin: 35
`reserve(2)` не създава елементи, но гарантира, че нито едно от двете вмъквания няма да преразпредели паметта. Затова `first` продължава да сочи към първия резултат и промяната повишава точките на Ада от 40 на 42.
Свързани уроци
- C++ · Урок 18 · Напреднало · Версия: 3
- C++ · Урок 32 · Напреднало · Версия: 3
- C++ · Урок 36 · Напреднало · Версия: 3
Източници
- WG21 N4950 — Working Draft, Standard for Programming Language C++ (C++23)
- C++ working draft — [vector.modifiers]
- C++ working draft — [sequence.reqmts]
- C++ working draft — [container.alloc.reqmts]
- C++ working draft — [vector.capacity]
- C++ working draft — [vector.overview]
- C++ working draft — [vector.bool.pspc]