命名空间
变体
操作

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

来自 cppreference.cn
 
C++
 
容器库
 
std::inplace_vector
成员类型
成员函数
非成员函数
 
constexpr pointer try_push_back( const T& value );
 (1) (自 C++26 起)
constexpr pointer try_push_back( T&& value );
 (2) (自 C++26 起)

有条件地将给定元素 value 追加到容器的末尾。

如果 size() == capacity() 为 true，则无效果。否则，追加类型为 T 的对象

1) 新元素被初始化为 value 的副本。
2) value 被移动到新元素中。

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

目录

[编辑] 参数

value - 要追加的元素的值
类型要求
-
T 必须满足 EmplaceConstructible 的要求。

[编辑] 返回值

std::addressof(back()) 如果 size() < capacity(), 否则为 nullptr。

[编辑] 复杂度

常数。

[编辑] 异常

插入元素初始化时抛出的任何异常。

如果由于任何原因抛出异常，这些函数不起作用（强异常安全保证）。

[编辑] 注释

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

[编辑] 示例

运行此代码
#include <cassert>
#include <inplace_vector>
#include <string>
 
int main()
{
    std::inplace_vector<std::string, 2> pets;
    std::string dog{"dog"};
 
    std::string* p1 = pets.try_push_back("cat"); // overload (1)
    assert(*p1 == "cat" and pets.size() == 1);
 
    std::string* p2 = pets.try_push_back(std::move(dog)); // overload (2)
    assert(*p2 == "dog" and pets.size() == 2);
 
    assert(pets[0] == "cat" and pets[1] == "dog");
    assert(pets.size() == pets.capacity());
 
    std::string* p3 = pets.try_push_back("bug");
    assert(p3 == nullptr and pets.size() == 2);
}

[编辑] 参见

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