std::deque<T,Allocator>::prepend_range
来自 cppreference.com
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})); }
[编辑] 另请参阅
(C++23) |
将一系列元素添加到末尾 (公共成员函数) |
(C++23) |
插入一系列元素 (公共成员函数) |
在开头插入元素 (公共成员函数) | |
(C++11) |
在开头就地构造元素 (公共成员函数) |