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"); // 未定义行为：无剩余空间
}

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

参见