Namespaces
Variants

std::deque<T,Allocator>:: prepend_range

From cppreference.net

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

以非逆序方式,在 begin() 之前插入 rg 中元素的副本。范围 rg 中的每个迭代器均会被精确解引用一次。

所有迭代器(包括 end() 迭代器)都将失效。所有引用保持有效。

目录

参数

rg - 一个 容器兼容范围 ,即元素可转换为 T input_range
类型要求
-
若满足以下任意条件,则行为未定义:

复杂度

线性于 rg 的大小。

注释

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

示例

#include <algorithm>
#include <cassert>
#include <deque>
#include <vector>
int main()
{
    auto container = std::deque{0, 1, 2, 3};
    const auto rg = std::vector{-3, -2, -1};
#if __cpp_lib_containers_ranges
    container.prepend_range(rg);
#else
    container.insert(container.begin(), rg.cbegin(), rg.cend());
#endif
    assert(std::ranges::equal(container, std::deque{-3, -2, -1, 0, 1, 2, 3}));
}

参见

在末尾添加一个元素范围
(公开成员函数)
插入一个元素范围
(公开成员函数)
在开头插入一个元素
(公开成员函数)
在开头原位构造元素
(公开成员函数)