std::vector<T,Allocator>::append_range
来自cppreference.com
template< container-compatible-range<T> R > void append_range( R&& rg ); |
(C++23 起) | |
以非逆序插入范围 rg 的各元素的副本到 end() 之前。
如果操作后新的 size() 大于原 capacity() 则会发生重分配，这种情况下，指代元素的所有迭代器（包括 end() 迭代器）和所有引用均会失效。否则仅有 end() 迭代器失效。
rg 中的每个迭代器均恰好被解引用一次。
目录 |
[编辑] 参数
| rg | - | 容器兼容范围，即各元素可以转换为 T 的 input_range
|
| 类型要求 | ||
-如果满足以下任意条件，那么行为未定义：
| ||
[编辑] 复杂度
如果发生了重分配，那么与结果 vector 的元素数量成线性；否则，与所插入元素数量加上到 end() 的距离成线性。
|
如果满足以下任一条件，那么最多只会进行一次重分配：
|
(C++26 起) |
[编辑] 异常
如果由除了 T 的复制构造函数、移动构造函数、复制赋值运算符或移动赋值运算符，或者 InputIterator 的任何操作之外抛出了异常，则没有效果。如果在末端插入单个元素时抛出了异常，且 T 为 可复制插入 (CopyInsertable) 或 std::is_nothrow_move_constructible_v<T> 为 true，则没有效果。否则，如果非可复制插入 (CopyInsertable) T 的移动构造函数抛出了异常，则其效果未指明。
注解
| 功能特性测试宏 | 值 | 标准 | 功能特性 |
|---|---|---|---|
__cpp_lib_containers_ranges |
202202L |
(C++23) | 按范围构造和插入 |
[编辑] 示例
运行此代码
#include <cassert> #include <vector> #include <list> int main() { auto head = std::vector{1, 2, 3, 4}; const auto tail = std::list{-5, -6, -7}; #ifdef __cpp_lib_containers_ranges head.append_range(tail); #else head.insert(head.end(), tail.cbegin(), tail.cend()); #endif assert((head == std::vector{1, 2, 3, 4, -5, -6, -7})); }
[编辑] 参阅
| (C++23) |
插入元素范围 (公开成员函数) |
| 将元素添加到容器末尾 (公开成员函数) | |
| (C++11) |
在容器末尾原位构造元素 (公开成员函数) |
