命名空间
变体
操作

std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::merge

来自 cppreference.cn
< cpp‎ | 容器‎ | 无序映射
 
 
 
 
template< class H2, class P2 >
void merge( std::unordered_map<Key, T, H2, P2, Allocator>& source );
(1) (C++17 起)
template< class H2, class P2 >
void merge( std::unordered_map<Key, T, H2, P2, Allocator>&& source );
(2) (C++17 起)
template< class H2, class P2 >
void merge( std::unordered_multimap<Key, T, H2, P2, Allocator>& source );
(3) (C++17 起)
template< class H2, class P2 >
void merge( std::unordered_multimap<Key, T, 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 <string>
#include <unordered_map>
#include <utility>
 
// print out a std::pair
template<class Os, class U, class V>
Os& operator<<(Os& os, const std::pair<U,V>& p)
{
    return os << '{' << p.first << ", " << p.second << '}';
}
 
// print out an associative container
template<class Os, class K, class V>
Os& operator<<(Os& os, const std::unordered_map<K, V>& v)
{
    os << '[' << v.size() << "] {";
    bool o{};
    for (const auto& e : v)
        os << (o ? ", " : (o = 1, "")) << e;
    return os << "}\n";
}
 
int main()
{
    std::unordered_map<std::string, int>
        p{{"C", 3}, {"B", 2}, {"A", 1}, {"A", 0}},
        q{{"E", 6}, {"E", 7}, {"D", 5}, {"A", 4}};
 
    std::cout << "p: " << p << "q: " << q;
 
    p.merge(q);
 
    std::cout << "p.merge(q);\n" << "p: " << p << "q: " << q;
}

可能的输出

p: [3] {{A, 1}, {B, 2}, {C, 3}}
q: [3] {{A, 4}, {D, 5}, {E, 6}}
p.merge(q);
p: [5] {{E, 6}, {D, 5}, {A, 1}, {B, 2}, {C, 3}}
q: [1] {{A, 4}}

[编辑] 参阅

(C++17)
从容器中提取节点
(public member function) [编辑]
插入元素 或节点(C++17 起)
(public member function) [编辑]