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

来自cppreference.com
 
 
 
 
template< class... Args >
constexpr reference emplace_back( Args&&... args );
(C++26 起)

向容器末尾追加一个新元素。通常用布置 new 将元素在容器所提供的位置进行原位构造。实参 args...std::forward<Args>(args)... 转发给构造函数。

没有迭代器或引用会失效。

参数

args - 要转发给元素构造函数的实参
类型要求
-
T (容器的元素类型) 必须满足可就位构造 (EmplaceConstructible)

返回值

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

复杂度

常数。

异常

  • 如果调用前 size() == capacity() 则会抛出 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 = [("🐈", "🐕"), ("🐈", "🐕")]

参阅

添加元素的范围到末尾
(公开成员函数)
将元素添加到容器末尾
(公开成员函数)
尝试将元素添加到容器末尾
(公开成员函数)
尝试在容器末尾原位构造元素
(公开成员函数)
尝试添加元素的范围到末尾
(公开成员函数)
无条件将元素添加到容器末尾
(公开成员函数)
无条件在容器末尾原位构造元素
(公开成员函数)
移除末元素
(公开成员函数)
创建拥有从实参推出的类型的 std::back_insert_iterator
(函数模板)