Namespaces
Variants

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

From cppreference.net

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 不可 复制插入 vector
2) T 不可 移动插入 vector
(C++11 起)

复杂度

摊销常数。

异常

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

T 的移动构造函数非 noexcept T 不可 复制插入 * 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
(函数模板)