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

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

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

Перед вызовом этой функции size() < capacity() должно быть true. В противном случае поведение не определено.

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

Параметры

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

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

Сложность

Постоянная.

Исключения

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

Примечания

Пример

#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.unchecked_emplace_back("\N{CAT}", dog);
    fauna.unchecked_emplace_back("\N{CAT}", std::move(dog));
    std::println("fauna = {}", fauna);

    // fauna.unchecked_emplace_back("BUG", "BUG"); // undefined behavior: no space
}

fauna = [("🐈", "🐕"), ("🐈", "🐕")]

См. также