std::unordered_set<Key,Hash,KeyEqual,Allocator>::merge
来自 cppreference.com
template< class H2, class P2 > void merge( std::unordered_set<Key, H2, P2, Allocator>& source ); |
(1) | (自 C++17 起) |
template< class H2, class P2 > void merge( std::unordered_set<Key, H2, P2, Allocator>&& source ); |
(2) | (自 C++17 起) |
template< class H2, class P2 > void merge( std::unordered_multiset<Key, H2, P2, Allocator>& source ); |
(3) | (自 C++17 起) |
template< class H2, class P2 > void merge( std::unordered_multiset<Key, H2, P2, Allocator>&& source ); |
(4) | (自 C++17 起) |
尝试提取(“拼接”)source 中的每个元素,并使用 *this 的哈希函数和键相等谓词将其插入到 *this 中。如果 *this 中存在一个元素,其键与 source 中元素的键等效,则该元素不会从 source 中提取。没有元素被复制或移动,只有容器节点的内部指针被重新指向。所有指向已转移元素的指针和引用仍然有效,但现在指向 *this,而不是 source。指向已转移元素的迭代器和所有指向 *this 的迭代器都将失效。指向 source 中剩余元素的迭代器仍然有效。
如果 get_allocator() != source.get_allocator(),则行为未定义。
内容 |
[编辑] 参数
source | - | 要从中转移节点的兼容容器 |
[编辑] 返回值
(无)
[编辑] 复杂度
平均情况为 O(N),最坏情况为 O(N * size() + N),其中 N 为 source.size()。
[编辑] 示例
运行此代码
#include <iostream> #include <unordered_set> // print out a container template<class Os, class K> Os& operator<<(Os& os, const std::unordered_set<K>& v) { os << '[' << v.size() << "] {"; bool o{}; for (const auto& e : v) os << (o ? ", " : (o = 1, " ")) << e; return os << " }\n"; } int main() { std::unordered_set<char> p{'C', 'B', 'B', 'A'}, q{'E', 'D', 'E', 'C'}; std::cout << "p: " << p << "q: " << q; p.merge(q); std::cout << "p.merge(q);\n" << "p: " << p << "q: " << q; }
可能的输出
p: [3] { A, B, C } q: [3] { C, D, E } p.merge(q); p: [5] { E, D, A, B, C } q: [1] { C }
[编辑] 另请参阅
(C++17) |
从容器中提取节点 (公共成员函数) |
插入元素 或节点(自 C++17 起) (公共成员函数) |