std::forward_list<T,Allocator>:: prepend_range
From cppreference.net
<
cpp
|
container
|
forward list
|
template
<
container-compatible-range
<
T
>
R
>
void prepend_range ( R && rg ) ; |
(C++23 起)
(自 C++26 起为 constexpr) |
|
以非逆序方式,在
begin()
之前插入
rg
中元素的副本。范围
rg
中的每个迭代器均被精确解引用一次。
不会使任何迭代器或引用失效。
目录 |
参数
| rg | - |
一个
容器兼容范围
,即其元素可转换为
T
的
input_range
|
| 类型要求 | ||
-
T
无法从
*
ranges::
begin
(
rg
)
原位构造
到
forward_list
中,则行为未定义。
|
||
复杂度
线性于 rg 的大小。
注释
| 功能测试 宏 | 值 | 标准 | 功能 |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | 支持范围 的构造与插入操作 |
示例
运行此代码
#include <algorithm> #include <cassert> #include <forward_list> #include <vector> int main() { auto container = std::forward_list{0, 1, 2, 3}; const auto rg = std::vector{-3, -2, -1}; #if __cpp_lib_containers_ranges container.prepend_range(rg); #else container.insert_after(container.before_begin(), rg.cbegin(), rg.cend()); #endif assert(std::ranges::equal(container, std::forward_list{-3, -2, -1, 0, 1, 2, 3})); }
参见
|
(C++23)
|
插入一个元素范围
(公开成员函数) |
|
(C++23)
|
在元素后插入一个元素范围
(公开成员函数) |
|
在开头插入元素
(公开成员函数) |
|
|
在开头原位构造元素
(公开成员函数) |