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

来自cppreference.com
 
C++
 
容器库
 
std::inplace_vector
成员类型
成员函数
非成员函数
 
<tbody> </tbody>
constexpr reference unchecked_push_back( const T& value );
 (1) (C++26 起)
constexpr reference unchecked_push_back( T&& value );
 (2) (C++26 起)
See More

将给定元素 value 追加到容器末尾。

等价于：return *try_push_back(std::forward<decltype(value)>(value));

1) 新元素是由 初始化新元素为 value 的副本。
2) 移动 value 进新元素。

在调用该函数之前，size() < capacity() 必须是 true。否则，其行为未定义。

除 end() 外没有迭代器或引用会失效，发生插入时 end() 失效。

参数

value - 要追加的元素值
类型要求
-
为使用重载 (1)， T 必须满足可复制插入 (CopyInsertable) 。
-
为使用重载 (2)， T 必须满足可移动插入 (MoveInsertable) 。

返回值

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

复杂度

常数。

异常

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

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

注解

本节未完成
原因：Explain the purpose of this API.

示例

运行此代码
#include <cassert>
#include <inplace_vector>
#include <string>

int main()
{
    std::inplace_vector<std::string, 2> fauna;
    std::string dog{"dog"};

    auto& r1 = fauna.unchecked_push_back("cat"); // overload (1)
    assert(r1 == "cat" and fauna.size() == 1);
    auto& r2 = fauna.unchecked_push_back(std::move(dog)); // overload (2)
    assert(r2 == "dog" and fauna.size() == 2);
    assert(fauna[0] == "cat" and fauna[1] == "dog");
    // fauna.unchecked_push_back("bug"); // undefined behavior: there is no space
}

参阅

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