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

void push_back( const T& value );

void push_back( T&& value );

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

如果操作后新的 size() 大于旧的 capacity()，则会重新分配内存，这种情况下所有迭代器（包括 end() 迭代器）和所有元素引用都将失效。否则只有 end() 迭代器失效。

参数

返回值

（无）

复杂度

摊销常数。

异常

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

注释

某些实现在 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: ""

参阅