命名空间
变体
操作

std::unordered_set<Key,Hash,KeyEqual,Allocator>::merge

来自 cppreference.com
< cpp‎ | 容器‎ | 无序集合
 
 
 
 
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 起)
(公共成员函数) [编辑]