命名空间
变体
操作

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

来自 cppreference.com
< cpp‎ | 容器‎ | 就地向量
 
C++
 
容器库
 
std::inplace_vector
成员类型
成员函数
非成员函数
 
template< class... Args >
constexpr pointer try_emplace_back( Args&&... args );
 (自 C++26)

有条件地将类型为 T 的对象追加到容器的末尾。

如果 size() == capacity() 为 true，则没有效果。否则，使用 std::forward<Args>(args)... 将类型为 T 的对象直接非列表初始化地追加。

除了 end()，所有迭代器或引用都不会失效，如果插入发生，则 end() 会失效。

内容

[编辑] 参数

args - 要转发给元素构造函数的参数
类型要求
-
T 必须 EmplaceConstructible 到 inplace_vector 中，来自 std::forward<Args>(args)....

[编辑] 返回值

std::addressof(back()) 如果 size() < capacity()，否则为 nullptr.

[编辑] 复杂度

常数。

[编辑] 异常

插入元素初始化时抛出的任何异常。如果由于任何原因抛出异常，则此函数没有效果 (强异常安全保证).

[编辑] 注释

本节内容不完整
原因：解释此 API 的目的。

[编辑] 示例

运行此代码
#include <cassert>
#include <complex>
#include <inplace_vector>
 
int main()
{
    using namespace std::complex_literals;
    using C = std::complex<double>;
    using I = std::inplace_vector<C, 3>;
    auto v = I{1.0 + 2.0i, 3.0 + 4.0i};
 
    C* c = v.try_emplace_back(5.0, 6.0);
    assert(*c == 5.0 + 6.0i);
    assert((v == I{1.0 + 2.0i, 3.0 + 4.0i, 5.0 + 6.0i}));
 
    c = v.try_emplace_back(7.0, 8.0); // no space => no insertion
    assert(c == nullptr);
    assert((v == I{1.0 + 2.0i, 3.0 + 4.0i, 5.0 + 6.0i}));
}

[编辑] 另请参阅

 在末尾就地构造元素
(公有成员函数) [编辑]
 在末尾添加元素
(公有成员函数) [编辑]
 在末尾添加一系列元素
(公有成员函数) [编辑]
 尝试在末尾添加一系列元素
(公有成员函数) [编辑]
 无条件地在末尾就地构造元素
(公有成员函数) [编辑]
 无条件地在末尾添加元素
(公有成员函数) [编辑]
 删除最后一个元素
(公有成员函数) [编辑]
 创建从参数推断类型的 std::back_insert_iterator
(函数模板) [编辑]
取自 "https://cppreference.cn/mwiki/index.php?title=cpp/container/inplace_vector/try_emplace_back&oldid=175521"