命名空间
变体
操作

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

来自 cppreference.cn
< 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
(函数模板) [编辑]