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

向容器末尾追加一个新元素。通常使用定位 new 在容器提供的位置就地构造元素。参数 args... 会作为 std:: forward < Args > ( args ) ... 转发给构造函数。

不会使任何迭代器或引用失效，除非插入操作发生时会使 end() 失效。

参数

返回值

back() ，即对插入元素的引用。

复杂度

常量。

异常

• 若调用前 size ( ) == capacity ( ) 则抛出 std::bad_alloc 。
• 插入元素初始化过程中抛出的任何异常。

若因任何原因抛出异常，这些函数将不产生任何效果（ 强异常安全保证 ）。

示例

#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}"); // 抛出异常：空间不足
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
    std::println("fauna = {}", fauna);
}

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

参见