std::vector<T,Allocator>::push_back
来自 cppreference.com
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 (函数模板) |