std::vector<T,Allocator>::push_back
来自 cppreference.cn
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()
或元素复制/移动构造函数/赋值),此函数没有效果(强异常保证)。
如果 |
(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: ""
[编辑] 参阅
(C++11) |
就地构造元素于结尾 (公共成员函数) |
移除末元素 (公共成员函数) | |
创建从参数推断类型的std::back_insert_iterator (函数模板) |