std::inplace_vector<T,N>::insert_range
来自cppreference.com
<tbody>
</tbody>
template< container-compatible-range<T> R > constexpr iterator insert_range( const_iterator pos, R&& rg ); |
(C++26 起) | |
以非降序，在 pos 之前插入 rg 中各元素的副本。
| 本节未完成 |
范围 rg 中的每个迭代器均恰好被解引用一次。
rg 与容器不能重叠，否则，其行为未定义。
参数
| pos | - | 将在其之前插入内容的迭代器（pos 可能是 end() 迭代器）
|
| rg | - | 容器兼容范围，即其元素可以转换为 T 的 input_range
|
| 类型要求 | ||
-T 必须从 *ranges::begin(rg) 向 inplace_vector 可就位构造 (EmplaceConstructible) 。否则，其行为未定义。
| ||
返回值
指向插入到 inplace_vector 中的第一个元素副本的 iterator，或当 rg 为空时为 pos。
异常
- 当
ranges::distance(rg) + size() > capacity()时抛出。不会改动*this中的元素。 - 由插入操作（即
T的复制/移动构造函数或复制/移动赋值运算符），或者由任何老式输入迭代器 (LegacyInputIterator) 的操作所抛出的任何异常。不会改动*this在范围[0,pos)中的元素。
示例
运行此代码
#include <cassert>
#include <inplace_vector>
#include <iterator>
#include <new>
#include <print>
int main()
{
auto v = std::inplace_vector<int, 8>{0, 1, 2, 3};
auto pos = std::next(v.begin(), 2);
assert(*pos == 2);
const auto rg = {-1, -2, -3};
v.insert_range(pos, rg);
std::println("{}", v);
try
{
assert(v.size() + rg.size() > v.capacity());
v.insert_range(pos, rg); // 抛出异常：没有空间
}
catch(const std::bad_alloc& ex)
{
std::println("{}", ex.what());
}
}
可能的输出：
[0, 1, -1, -2, -3, 2, 3]
std::bad_alloc
参阅
| 插入元素 (公开成员函数) | |
| 添加元素的范围到末尾 (公开成员函数) | |
| 尝试添加元素的范围到末尾 (公开成员函数) |