std::deque<T,Allocator>::insert_range
来自cppreference.com
template< container-compatible-range<T> R > iterator insert_range( const_iterator pos, R&& rg ); |
(C++23 起) (C++26 起为 constexpr) |
|
以非降序，在 pos 之前插入 rg 中各元素的副本。
所有迭代器（包括 end() 迭代器）都会失效。引用也会失效，除非 pos == begin() 或 pos == end()，此时它们不会失效。
范围 rg 中的每个迭代器均恰好被解引用一次。
如果 rg 与 *this 有重叠，那么行为未定义。
目录 |
[编辑] 参数
| pos | - | 将在其之前插入内容的迭代器（pos 可能是 end() 迭代器）
|
| rg | - | 容器兼容范围，即其元素可以转换为 T 的 input_range
|
| 类型要求 | ||
-如果满足以下任意条件，那么行为未定义：
| ||
[编辑] 返回值
返回指向插入到 *this 中的第一个元素的迭代器，或在 rg 为空时返回 pos。
注解
| 功能特性测试宏 | 值 | 标准 | 功能特性 |
|---|---|---|---|
__cpp_lib_containers_ranges |
202202L |
(C++23) | 按范围构造和插入 |
[编辑] 示例
运行此代码
#include <algorithm> #include <cassert> #include <iterator> #include <deque> #include <list> int main() { auto container = std::deque{1, 2, 3, 4}; auto pos = std::next(container.begin(), 2); assert(*pos == 3); const auto rg = std::list{-1, -2, -3}; #ifdef __cpp_lib_containers_ranges container.insert_range(pos, rg); #else container.insert(pos, rg.cbegin(), rg.cend()); #endif assert(std::ranges::equal(container, std::deque{1, 2, -1, -2, -3, 3, 4})); }
[编辑] 参阅
| 插入元素 (公开成员函数) | |
| (C++23) |
添加元素的范围到起始 (公开成员函数) |
| (C++23) |
添加元素的范围到末尾 (公开成员函数) |
