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

来自cppreference.com
< cpp‎ | container‎ | vector

[编辑模板]
 
C++
 
容器库
 
std::vector
成员类型
成员函数
非成员函数
(C++20 前)(C++20 前)(C++20 前)(C++20 前)(C++20 前)
推导指引(C++17)
 
void push_back( const T& value );
 (1) (C++20 起为 constexpr)
void push_back( T&& value );
 (2) (C++11 起)
(C++20 起为 constexpr)

追加 value 的副本到容器尾。

如果操作后新的 size() 大于原 capacity() 则会发生重分配，这种情况下，指代元素的所有迭代器（包括 end() 迭代器）和所有引用均会失效。否则仅有 end() 迭代器失效。

目录

[编辑] 参数

value - 要追加的元素值

类型要求
-
如果满足以下条件，那么行为未定义：
1) T 不可复制插入 (CopyInsertable) 到 vector 中。
2) T 不可移动插入 (MoveInsertable) 到 vector 中。
 (C++11 起)

[编辑] 复杂度

均摊常数。

[编辑] 异常

如果抛出异常（可能因为 Allocator::allocate() 或元素复制/移动构造函数/赋值），那么此函数无效果（强异常保证）。

如果 T 的移动构造函数不是 noexcept 的且 T 不可复制插入 (CopyInsertable) 到 *this，那么 vector 将使用会抛出的移动构造函数。如果它抛出，那么豁免此保证且效果未指定。

(C++11 起)

注解

一些实现在 push_back 导致会超出 max_size 的重分配时会抛出 std::length_error，这是由于这会隐式调用 reserve(size() + 1) 的等价者。

[编辑] 示例

运行此代码
#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 持有：";
    for (auto&& e : letters)
        std::cout << std::quoted(e) << ' ';
 
    std::cout << "\n被移动的 string s 持有：" << std::quoted(s) << '\n';
}

可能的输出： 

std::vector letters 持有："abc" "def"
被移动的字符串 s 持有：""

[编辑] 参阅

(C++11)
 在容器末尾原位构造元素
(公开成员函数)