Namespaces
Variants

std::list<T,Allocator>:: assign_range

From cppreference.net

C++
Containers library
std::list
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
template < container-compatible-range < T > R >
void assign_range ( R && rg ) ;
(C++23 起)
(C++26 起为 constexpr)

将容器中的元素替换为 rg 中每个元素的副本。

所有迭代器（包括 end() 迭代器）及所有对元素的引用都会失效。

范围内的每个迭代器 rg 都会被精确解引用一次。

如果 rg 与 * this 存在重叠，则行为未定义。

目录

参数

rg - 一个 input_range ，其引用类型可转换为容器的元素类型
类型要求
-
若 std:: assignable_from < T & , ranges:: range_reference_t < R >> 未被建模，则程序非良构
-
若 T 无法从 * ranges:: begin ( rg ) 进行 EmplaceConstructible 到 list ，则行为未定义

注释

功能测试 宏 值 标准 功能特性
__cpp_lib_containers_ranges 202202L (C++23) 支持范围 的构造与插入操作

示例

运行此代码 
#include <algorithm>
#include <cassert>
#include <list>
#include <vector>
int main()
{
    const auto source = std::vector{2, 7, 1};
    auto destination = std::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)
在开头添加元素范围
(公开成员函数)
(C++23)
在末尾添加元素范围
(公开成员函数)
为容器赋值
(公开成员函数)
为容器赋值
(公开成员函数)