std::inplace_vector<T,N>::emplace_back
来自cppreference.com
< cpp | container | inplace vector
template< class... Args > constexpr reference emplace_back( Args&&... args ); |
(C++26 起) | |
向容器末尾追加一个新元素。通常用布置 new 将元素在容器所提供的位置进行原位构造。实参 args... 以 std::forward<Args>(args)... 转发给构造函数。
没有迭代器或引用会失效。
参数
args | - | 要转发给元素构造函数的实参 |
类型要求 | ||
-T (容器的元素类型) 必须满足可就位构造 (EmplaceConstructible) 。
|
返回值
back()
,即对所插入元素的引用。
复杂度
常数。
异常
- 如果调用前 size() == capacity() 则会抛出 bad_alloc。
- 被插入元素的初始化所抛出的任何异常。
如果因为任何原因抛出了异常,那么这些函数无效果(强异常安全保证)。
示例
运行此代码
#include <inplace_vector> #include <new> #include <print> #include <string> #include <utility> int main() { std::inplace_vector<std::pair<std::string, std::string>, 2> fauna; std::string dog{"\N{DOG}"}; fauna.emplace_back("\N{CAT}", dog); fauna.emplace_back("\N{CAT}", std::move(dog)); std::println("fauna = {}", fauna); try { fauna.emplace_back("\N{BUG}", "\N{BUG}"); // 抛出异常: 没有空间 } catch(const std::bad_alloc& ex) { std::println("{}", ex.what()); } std::println("fauna = {}", fauna); }
可能的输出:
fauna = [("🐈", "🐕"), ("🐈", "🐕")] std::bad_alloc fauna = [("🐈", "🐕"), ("🐈", "🐕")]
参阅
添加元素的范围到末尾 (公开成员函数) | |
将元素添加到容器末尾 (公开成员函数) | |
尝试将元素添加到容器末尾 (公开成员函数) | |
尝试在容器末尾原位构造元素 (公开成员函数) | |
尝试添加元素的范围到末尾 (公开成员函数) | |
无条件将元素添加到容器末尾 (公开成员函数) | |
无条件在容器末尾原位构造元素 (公开成员函数) | |
移除末元素 (公开成员函数) | |
创建拥有从实参推出的类型的 std::back_insert_iterator (函数模板) |