Namespaces
Variants

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

来自 zh.cppreference.net

 
 
 
 
template< /*container-compatible-range*/<T> R >
constexpr 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 ) 进行 就地构造 到 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));
}

参见

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