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

来自cppreference.com
 
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() 外没有迭代器或引用会失效，发生插入时 end() 失效。

参数

value - 要追加的元素值
类型要求
-
T 必须满足可就位构造 (EmplaceConstructible) 。

返回值

std::addressof(back())，如果 size() < capacity()，否则是 nullptr。

复杂度

常数。

异常

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

如果因为任何原因抛出了异常，那么这些函数无效果（强异常安全保证）。

注解

本节未完成
原因：Explain the purpose of this 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
(函数模板) [编辑]