命名空间
变体
操作

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

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

在容器末尾添加一个新元素。通常,该元素通过placement-new 在容器提供的位置原地构造。参数args... 被转发给构造函数,形如 std::forward<Args>(args)...

除了 end()(如果发生插入则会失效)之外,没有迭代器或引用会失效。

目录

[编辑] 参数

args - 转发给元素构造函数的参数
类型要求
-
T 必须满足 EmplaceConstructible 的要求。

[编辑] 返回值

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}"); // throws: there is no space
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
    std::println("fauna = {}", fauna);
}

可能的输出

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

[编辑] 参阅

添加一个元素范围到结尾
(public member function) [编辑]
添加元素到结尾
(public member function) [编辑]
尝试在末尾添加元素
(public member function) [编辑]
尝试在末尾就地构造元素
(public member function) [编辑]
尝试在末尾添加一系列元素
(public member function) [编辑]
无条件地在末尾添加元素
(public member function) [编辑]
无条件地在末尾就地构造元素
(public member function) [编辑]
移除末元素
(public member function) [编辑]
创建从参数推断类型的std::back_insert_iterator
(function template) [编辑]