命名空间
变体
操作

std::vector<T,Allocator>::push_back

来自 cppreference.com
< cpp‎ | 容器‎ | vector
 
 
 
 
void push_back( const T& value );
(1) (从 C++20 开始为 constexpr)
void push_back( T&& value );
(2) (从 C++11 开始)
(从 C++20 开始为 constexpr)

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

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

如果操作后新的 size() 大于旧的 capacity(),将进行重新分配,在这种情况下,所有迭代器(包括 end() 迭代器)以及对元素的所有引用将失效。否则,只有 end() 迭代器将失效。

内容

[编辑] 参数

value - 要附加的元素的值
类型要求
-
为了使用重载 (1),T 必须满足 CopyInsertable 的要求。
-
为了使用重载 (2),T 必须满足 MoveInsertable 的要求。

[编辑] 返回值

(无)

[编辑] 复杂度

均摊常数。

[编辑] 异常

如果抛出异常(可能是由于 Allocator::allocate() 或元素复制/移动构造函数/赋值操作),则此函数不会产生任何影响 (强异常保证)。

如果 T 的移动构造函数不是 noexceptT 不能 CopyInsertable*this 中,vector 将使用抛出移动构造函数。如果它抛出,则保证会被放弃,效果未定义。

(从 C++11 开始)

备注

某些实现会在 push_back 导致的重新分配超过 max_size 时(由于隐式调用等效于 reserve(size() + 1)) 时抛出 std::length_error

[编辑] 示例

#include <iomanip>
#include <iostream>
#include <string>
#include <vector>
 
int main()
{
    std::vector<std::string> letters;
 
    letters.push_back("abc");
    std::string s{"def"};
    letters.push_back(std::move(s));
 
    std::cout << "std::vector letters holds: ";
    for (auto&& e : letters)
        std::cout << std::quoted(e) << ' ';
 
    std::cout << "\nMoved-from string s holds: " << std::quoted(s) << '\n';
}

可能的输出

std::vector letters holds: "abc" "def"
Moved-from string s holds: ""

[编辑] 另请参阅

在末尾就地构造元素
(公有成员函数) [编辑]
删除最后一个元素
(公有成员函数) [编辑]
创建从参数推断类型的 std::back_insert_iterator
(函数模板) [编辑]