std::unordered_set<Key,Hash,KeyEqual,Allocator>:: insert_range
|
template
<
container-compatible-range
<
value_type
>
R
>
void insert_range ( R && rg ) ; |
(C++23 起)
(C++26 起为 constexpr) |
|
当且仅当在 * this 中不存在与指定范围内元素键值相等的元素时,插入该范围内每个元素的副本。
范围内的每个迭代器 rg 都会被精确解引用一次。
若满足以下任一条件,则行为未定义:
-
value_type无法从 * ranges:: begin ( rg ) 就位构造到unordered_set中 - rg 与 * this 存在重叠
如果在操作后新元素数量大于旧的
max_load_factor()
*
bucket_count()
将发生重新哈希。
如果发生重新哈希(由于插入操作),所有迭代器都会失效。否则(未发生重新哈希),迭代器不会失效。
目录 |
参数
| rg | - |
一个
容器兼容范围
,即其元素可转换为
T
的
input_range
|
复杂度
平均情况 N ,最坏情况 O(N·S+N) ,其中 S 是 size ( ) 且 N 是 ranges:: distance ( rg ) 。
注释
| 功能测试 宏 | 值 | 标准 | 功能 |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | 支持范围 的构造与插入操作 |
示例
#include <iostream> #include <unordered_set> void println(auto, const auto& container) { for (const auto& elem : container) std::cout << elem << ' '; std::cout << '\n'; } int main() { auto container = std::unordered_set{1, 3, 2, 4}; const auto rg = {-1, 3, -2}; #ifdef __cpp_lib_containers_ranges container.insert_range(rg); #else container.insert(rg.begin(), rg.end()); #endif println("{}", container); }
可能的输出:
4 -1 2 3 -2 1
参见
|
插入元素
或节点
(C++17 起)
(公开成员函数) |