Namespaces
Variants

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

    来自 zh.cppreference.net

     
    C++
     
    容器库
     
    std::list
    成员函数
    非成员函数
    (至 C++20)(至 C++20)(至 C++20)(至 C++20)(至 C++20)
    推导指引(C++17)
     
    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 无法从 * 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)
    		在末尾添加元素范围
    (公开成员函数)
    		为容器赋值
    (公开成员函数)
    		为容器赋值
    (公开成员函数)