std::forward_list<T,Allocator>::assign_range
来自 cppreference.com
< cpp | container | forward list
template< container-compatible-range<T> R > void assign_range( R&& rg ); |
(自 C++23 起) | |
用 rg 中每个元素的副本替换容器中的元素。
所有迭代器(包括 end()
迭代器)和所有对元素的引用都将失效。
范围 rg 中的每个迭代器都会被解除引用一次。
如果 rg 与容器重叠,则行为未定义。
内容 |
[编辑] 参数
rg | - | 一个 input_range ,其引用类型可转换为容器的元素类型 |
类型要求 | ||
-std::assignable_from<T&, ranges::range_reference_t<R>> 必须建模。否则,程序将格式错误。 | ||
-T 必须是 EmplaceConstructible 到容器中,来自 *ranges::begin(rg)。否则,行为未定义。 |
[编辑] 返回值
(无)
注释
特性测试 宏 | 值 | Std | 特性 |
---|---|---|---|
__cpp_lib_containers_ranges |
202202L | (C++23) | 支持范围的 构造和插入 |
[编辑] 示例
运行此代码
#include <algorithm> #include <cassert> #include <forward_list> #include <list> int main() { const auto source = std::list{2, 7, 1}; auto destination = std::forward_list{3, 1, 4}; #ifdef __cpp_lib_containers_ranges destination.assign_range(source); #else destination.assign(source.cbegin(), source.cend()); #endif assert(std::ranges::equal(source, destination)); }
[编辑] 另请参见
(C++23) |
在元素之后插入一系列元素 (公有成员函数) |
(C++23) |
在开头添加一系列元素 (公有成员函数) |
将值分配给容器 (公有成员函数) | |
将值分配给容器 (公有成员函数) |