Namespaces
Variants

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

From cppreference.net

template < container-compatible-range < T > R >
constexpr void assign_range ( R && rg ) ;
(C++23 起)

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

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

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

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

目录

参数

rg - 一个 input_range ,其引用类型可转换为容器的元素类型
类型要求
-
std:: assignable_from < T & , ranges:: range_reference_t < R >> 未被建模,则程序非良构。
-
T 无法从 * ranges:: begin ( rg ) 进行 就地构造 vector 中,则行为未定义。
-
若满足以下任一条件,且 T 无法 移动插入 vector 中,则行为未定义:
(C++26 前)
(C++26 起)

注释

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

示例

#include <algorithm>
#include <cassert>
#include <vector>
#include <list>
int main()
{
    const auto source = std::list{2, 7, 1};
    auto destination = std::vector{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));
}

参见

插入一个元素范围
(公开成员函数)
在末尾添加一个元素范围
(公开成员函数)
为容器赋值
(公开成员函数)
为容器赋值
(公开成员函数)