std::inplace_vector<T,N>::emplace_back

template< class... Args >
constexpr reference emplace_back( Args&&... args );

Добавляет новый элемент в конец контейнера. Обычно элемент конструируется с помощью placement-new, чтобы создать его непосредственно в месте, предоставленном контейнером. Аргументы args... передаются конструктору как std::forward<Args>(args)....

Ни один итератор или ссылка не становятся недействительными, кроме end(), который становится недействительным, если происходит вставка.

Параметры

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

back(), то есть ссылка на вставленный элемент.

Сложность

Постоянная.

Исключения

• std::bad_alloc, если size() == capacity() до вызова.
• Любое исключение, выброшенное при инициализации вставленного элемента.

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

Пример

#include <inplace_vector>
#include <new>
#include <print>
#include <string>
#include <utility>

int main()
{
    std::inplace_vector<std::pair<std::string, std::string>, 2> fauna;
    std::string dog{"\N{DOG}"};

    fauna.emplace_back("\N{CAT}", dog);
    fauna.emplace_back("\N{CAT}", std::move(dog));
    std::println("fauna = {}", fauna);

    try
    {
        fauna.emplace_back("\N{BUG}", "\N{BUG}"); // throws: there is no space
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
    std::println("fauna = {}", fauna);
}

fauna = [("🐈", "🐕"), ("🐈", "🐕")]
std::bad_alloc
fauna = [("🐈", "🐕"), ("🐈", "🐕")]

См. также