std::vector<T,Allocator>:: push_back
|
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 | - | 要追加的元素值 |
|
(C++11 起) | ||||||
复杂度
摊销常数。
异常
如果抛出异常(可能由于
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
(函数模板) |