命名空间
变体
操作

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

来自 cppreference.com
< cpp‎ | container‎ | deque
 
 
 
 
template< container-compatible-range<T> R >
void prepend_range( R&& rg );
(自 C++23 起)

以非反转顺序插入 rg 中元素的副本,位于 begin() 之前。范围 rg 中的每个迭代器都恰好被解引用一次。

所有迭代器(包括 end() 迭代器)都将失效。没有任何引用失效。

内容

[编辑] 参数

rg - 一个 与容器兼容的范围,即元素可转换为 T输入范围
类型要求
-
T 必须 可就地构造deque 中,来自 *ranges::begin(rg)。此外,T 必须 可移动插入deque 中,并且 T 满足 可移动构造可移动赋值可交换。否则,行为未定义。

[编辑] 返回值

(无)

[编辑] 复杂度

rg 大小成线性关系。

[编辑] 备注

功能测试 Std 功能
__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}));
}

[编辑] 另请参阅

将一系列元素添加到末尾
(公共成员函数)
插入一系列元素
(公共成员函数)
在开头插入元素
(公共成员函数)
在开头就地构造元素
(公共成员函数)