std::unordered_map<Key,T,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无法通过 EmplaceConstructible 方式从 * ranges:: begin ( rg ) 构造到unordered_map中 - 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_map> #include <utility> void println(auto, const auto& container) { for (const auto& [key, value] : container) std::cout << '{' << key << ',' << value << '}' << ' '; std::cout << '\n'; } int main() { auto container = std::unordered_map{std::pair{1, 11}, {3, 33}, {2, 22}, {4, 44}}; const auto rg = {std::pair{-1, -11}, {3, -33}, {-2, -22}}; #ifdef __cpp_lib_containers_ranges container.insert_range(rg); #else container.insert(rg.begin(), rg.end()); #endif println("{}", container); }
可能的输出:
{4,44} {-1,-11} {2,22} {3,33} {-2,-22} {1,11}
另请参阅
|
插入元素
或节点
(C++17 起)
(公开成员函数) |