unordered_map介绍

unordered_map 是关联容器，含有带唯一键的键(key;it->first)-值(value;it->second) pair 。搜索、插入和元素移除拥有平均常数时间复杂度。

元素在内部不以任何特定顺序排序，而是组织进桶中。元素放进哪个桶完全依赖于其键的哈希。这允许对单独元素的快速访问，因为一旦计算哈希，则它准确指代元素所放进的桶。

Hashtable和bucket

由于unordered_map内部采用的hashtable的数据结构存储，所以，每个特定的key会通过一些特定的哈希运算映射到一个特定的位置，我们知道，hashtable是可能存在冲突的（多个key通过计算映射到同一个位置），在同一个位置的元素会按顺序链在后面。所以把这个位置称为一个bucket是十分形象的（像桶子一样，可以装多个元素）。

函数使用

1.成员函数(构造函数，赋值运算)

函数	功能说明
unordered_map() : unordered_map( size_type(/implementation-defined/) )	默认构造函数，构造空容器。
template< class InputIt > unordered_map( InputIt first, InputIt last,size_type bucket_count,const Hash& hash,const Allocator& alloc ) : unordered_map(first, last, bucket_count, hash, key_equal(), alloc) {}	列表构造函数，构造拥有范围 [first, last) 的内容的容器。
unordered_map( const unordered_map& other );	复制构造函数。
unordered_map( unordered_map&& other );	移动构造函数。用移动语义构造拥有 other 内容的容器。
unordered_map( std::initializer_list<value_type> init,size_type bucket_count,const Allocator& alloc ) : unordered_map(init, bucket_count,Hash(), key_equal(), alloc) {}	范围构造函数，构造拥有 initializer_list init 内容的容器，同 unordered_map(init.begin(), init.end()) 。参数
unordered_map& operator**=**( const unordered_map& other );	复制赋值运算符。以 other 的副本替换内容。
unordered_map& operator**=**( unordered_map&& other );	移动赋值运算符。用移动语义以 other 的内容替换内容（即从 other 移动 other 中的数据到此容器中）。
unordered_map& operator**=**( std::initializer_list<value_type> ilist );	以 initializer_list ilist 所标识者替换内容。

实现

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    // 默认构造函数：空 unordered_map
    unordered_map<int, string> m1;

    // 列表构造函数
    unordered_map<int, string> m2 = { {1,"This"},{2,"is"} };

    // 复制构造函数
    unordered_map<int, string> m3 = m2;

    // 移动构造函数
    unordered_map<int, string> m4 = move(m3);

    // 范围构造函数
    unordered_map<int, string> m5(m3.begin(), m3.end());


    return 0;
}

2.迭代器（begin();cbegin();end();cend()）

迭代器	功能说明
iterator begin() ;	返回指向 unordered_map 首元素的迭代器。若 unordered_map 为空，则返回的迭代器将等于 end() 。
const_iterator cbegin() const ;	返回指向 unordered_map 首元素的迭代器。若 unordered_map 为空，则返回的迭代器将等于 end() 。
iterator end() ;	返回指向 unordered_map 末元素后一元素的迭代器。此元素表现为占位符；试图访问它导致未定义行为。
const_iterator cend() const;	返回指向 unordered_map 末元素后一元素的迭代器。此元素表现为占位符；试图访问它导致未定义行为。

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    
    unordered_map<int, string> m1 = { {1,"This"},{2,"is"},{3,"an"},{4,"apple"} };
    
    
    for (auto it = m1.begin(); it != m1.end(); it++)
    {
        cout << it->first <<"  " <<it->second << endl;
    }


    return 0;
}

3.容量(empty();size();max_size() 😉

函数	功能
bool empty() const ;	检查容器是否无元素，即是否 begin() == end() 。
size_type size() const ;	返回容器中的元素数，即 std::distance(begin(), end()) 。
size_type max_size() const ;	返回根据系统或库实现限制的容器可保有的元素最大数量，即对于最大容器的 std::distance(begin(), end()) 。

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    
    unordered_map<int, string> m1 = { {1,"This"},{2,"is"},{3,"an"},{4,"apple"} };
    
    
    cout << "m1.empty():" << m1.empty() << endl;
    cout << "m1.size():" << m1.size() << endl;
    cout << "m1.max_size():" << m1.max_size() << endl;


    return 0;
}

3.修改器(clear;insert;insert_or_assign;emplace;emplace_hint;try_emplace;erase;swap;extract;merge)

函数	功能
void clear() ;	从容器擦除所有元素。此调用后 size() 返回零。
std::pair<iterator,bool> insert( const value_type& value );	插入 value 。
iterator insert( const_iterator hint, value_type&& value )	插入 value ，以 hint 为应当开始搜索的位置的非强制建议。
template< class InputIt >
void insert( InputIt first, InputIt last );	插入来自范围 [first, last) 的元素。
void insert( std::initializer_list<value_type> ilist );	插入来自 initializer_list ilist 的元素。
template
std::pair<iterator, bool> insert_or_assign(const key_type& k, M&& obj);	若等价于 k 的键已存在于容器中，则赋值 std::forward(obj) 给对应于键 k 的 mapped_type 。若键不存在，则如同用 insert 插入从 value_type(k, std::forward(obj)) 构造的新值。
template< class… Args >
std::pair<iterator,bool> emplace( Args&&… args );	容器中无拥有该关键的元素，则插入以给定的 args 原位构造的新元素到容器。
template <class… Args>
iterator emplace_hint( const_iterator hint, Args&&… args );	插入新元素到容器，以 hint 为应当放置新元素位置的建议。原位构造元素，即不进行复制或移动操作。
template <class… Args>
pair<iterator, bool> try_emplace(const key_type& k, Args&&… args);	若容器中已存在等价于 k 的关键，则不做任何事。
iterator erase( iterator pos );	移除位于 pos 的元素
iterator erase( const_iterator first, const_iterator last );	移除范围 [first; last) 中的元素，它必须是 *this 中的合法范围。
size_type erase( const key_type& key );	移除键等价于 key 的元素（如果存在一个）。
template< class K >
size_type erase( K&& x );	移除键比较等价于值 x 的元素（如果存在一个）。
void swap( unordered_map& other );	将内容与 other 的交换。不在单独的元素上调用任何移动、复制或交换操作。
node_type extract( const_iterator position );	解链含 position 所指向元素的结点并返回占有它的结点柄。
node_type extract( const key_type& k );	若容器拥有元素而其关键等于 x ，则从容器解链该元素并返回占有它的结点柄。
template<class H2, class P2>
void merge( std::unordered_map<Key, T, H2, P2, Allocator>& source );	试图提取（“接合”） source 中每个元素，并用 *this 的散列函数与键相等谓词插入到 *this 。

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    
    unordered_map<int, string> m1 = { {1,"This"},{2,"is"},{3,"an"},{4,"apple"} };
    unordered_map<int, string> m2;
    m1.insert({ 5,"three" });
    m1.insert_or_assign(6,"windows" );
    m1.emplace(7, "u盘");
    m1.try_emplace(8, "u盘");

    cout << "m1----------" << endl;
    for (auto it = m1.begin(); it != m1.end(); it++)
    {
        cout << it->first << "-->" << it->second << endl;
    }

    m1.erase(m1.begin());
    cout << "m1----------" << endl;
    for (auto it = m1.begin(); it != m1.end(); it++)
    {
        cout << it->first << "-->" << it->second << endl;
    }
    m1.swap(m2);
    cout << "m1----------" << endl;
    for (auto it = m1.begin(); it != m1.end(); it++)
    {
        cout << it->first << "-->" << it->second << endl;
    }
    cout << "m2----------" << endl;
    for (auto it = m2.begin(); it != m2.end(); it++)
    {
        cout << it->first << "-->" << it->second << endl;
    }
    

    return 0;
}

4.查找(at;operator[];count; find;contains;equal_range;)

函数	功能
T& at( const Key& key );	返回到拥有等于 key 的关键的元素被映射值的引用。
T& operator[]( const Key& key );	返回到映射到等于 key 的键的值的引用，若这种键不存在则进行插入。
T& operator[]( Key&& key );	返回到映射到等于 key 的键的值的引用，若这种键不存在则进行插入。
size_type count( const Key& key ) const;	返回拥有比较等于指定参数 key 的关键的元素数，因为此容器不允许重复故为 1 或 0 。
template< class K >
size_type count( const K& x ) const;	返回键比较等价于指定参数 x 的元素数。
iterator find( const Key& key );	寻找键等于 key 的的元素。
bool contains( const Key& key ) const;	检查容器中是否有键等价于 key 的元素。若有这种元素则为 true ，否则为 false 。
std::pair<iterator,iterator> equal_range( const Key& key );	返回容器中所有键等于 key 的元素范围。范围以二个迭代器定义，指向所需范围的首元素，
std::pair<const_iterator,const_iterator> equal_range( const Key& key ) const;	返回容器中所有键等于 key 的元素范围。范围以二个迭代器定义，指向范围的尾后一位元素。

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    
    unordered_map<int, string> m1 = { {1,"This"},{2,"is"},{3,"an"},{4,"apple"},{1,"summer"} };

    cout << "m1----------" << endl;
    for (auto it = m1.begin(); it != m1.end(); it++)
    {
        cout << it->first << "-->" << it->second << endl;
    }

    string x = m1.at(1);
    cout << "m1.at(1): " << x << endl;

    m1[1] = "paper";//更新既存值
    m1[6] = "water";//插入新值

    cout << "m1.count(1): " << m1.count(1) << endl;
    
    auto it = m1.find(2);
    cout << it->first << "-->" << it->second << endl;

    auto range = m1.equal_range(1);
    for (it = range.first; it != range.second; ++it) 
    {
        std::cout << it->first << "--->"<< it->second << '\n';
    }

    cout << "m1----------" << endl;
    for (auto it = m1.begin(); it != m1.end(); it++)
    {
        cout << it->first << "-->" << it->second << endl;
    }
       

    return 0;
}

补充find()函数用法

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    unordered_map<int, int> map;
    map.insert({ 4,1 });
    map.insert({ 5,1 });
    map.insert({ 6,2 });

    if (map.find(5) != map.end())
    {
        cout << "success";
    }

    return 0;
}

5.桶接口(begin;cbegin;end;cend;bucket_count;max_bucket_count;bucket_size;bucket)

桶接口	功能
local_iterator begin( size_type n );	返回指向下标为 n 的桶首元素的迭代器。
const_local_iterator cbegin( size_type n ) const;	返回指向下标为 n 的桶首元素的迭代器。
local_iterator end( size_type n );	返回后随下标为 n 的桶的最后元素的元素的迭代器。
const_local_iterator cend( size_type n ) const;	返回后随下标为 n 的桶的最后元素的元素的迭代器。
size_type bucket_count() const;	返回容器中的桶数。
size_type max_bucket_count() const;	返回容器由于系统或库实现限制的能保有的最大桶数。
size_type bucket_size( size_type n ) const;	返回下标为 n 的桶中的元素数。
size_type bucket( const Key& key ) const;	返回关键 key 的桶的下标。始终会在此桶中找到关键等于 key 的元素（若存在）。返回值仅对 bucket_count() 返回相同值的容器实例合法。若 bucket_count() 为零则行为未定义。

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    
    unordered_map<int, string> m1 = { {1,"This"},{2,"is"},{3,"an"},{4,"apple"},{5,"summer"} };

    int n = m1.bucket_count();//返回桶数
    cout << "m1.bucket_count():  " << n << endl;
       
    for (int i = 0; i < n; i++)
    {
        cout << "bucket[" << i << "]" << ".size()" << m1.bucket_size(i) << "contains: ";
        for (auto it = m1.begin(i); it != m1.end(i); it++)
        {
            cout << "[" << it->first << "-->" << it->second << "]";
        }
        cout << endl;
    }

    cout << "1 in the bucket" << m1.bucket(1) << endl;

    return 0;
}

6.哈希策略(load_factor;max_load_factor;rehash;reserve)

哈希策略	功能
float load_factor() const;	返回每个桶元素的平均数，即 size() 除以 bucket_count() 。
float max_load_factor() const;	管理最大加载因子（每个桶的平均元素数）。返回最大加载因子。
void max_load_factor( float ml );	管理最大加载因子（每个桶的平均元素数）。设置最大加载因子为 ml 。
void rehash( size_type count );	设置桶数为 count 并重哈希容器，即考虑桶总数已改变，再把元素放到适当的桶中。
void reserve( size_type count );	设置桶数为适应至少 count 个元素，而不超出最大加载因子所需的数，并重哈希容器，即考虑桶数已更改后将元素放进适合的桶。

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    
    unordered_map<int, string> m1 = { {1,"This"},{2,"is"},{3,"an"},{4,"apple"},{5,"summer"} };

    int n = m1.bucket_count();//返回桶数
    cout << "m1.bucket_count():  " << n << endl;
       
    for (int i = 0; i < n; i++)
    {        
        cout << "buckst's load_factor:(每个桶的平均元素数量) " << m1.load_factor() <<"  ";
        cout << "bucket[" << i << "]" << ".size():" << m1.bucket_size(i) << "contains: ";

        for (auto it = m1.begin(i); it != m1.end(i); it++)
        {
            cout << "[" << it->first << "-->" << it->second << "]";
        }
        cout << endl;
    }

    cout << "1 in the bucket" << m1.bucket(1) << endl;

    m1.rehash(16);
    for (int i = 0; i < n; i++)
    {
        cout << "buckst's load_factor:(每个桶的平均元素数量) " << m1.load_factor() << "  ";
        cout << "bucket[" << i << "]" << ".size()：" << m1.bucket_size(i) ;

        
        cout << endl;
    }

    return 0;
}

7.观察器(hash_function;key_eq)

观察期	功能说明
hasher hash_function() const;	返回对关键哈希的函数。
key_equal key_eq() const;	返回比较关键相等性的函数。

8.非成员函数(operator==;std::swap;erase_if;)

非成员函数	功能
template< class Key, class T, class Hash, class KeyEqual, class Allocator >bool operator==( const std::unordered_map<Key,T,Hash,KeyEqual,Allocator>& lhs,const std::unordered_map<Key,T,Hash,KeyEqual,Allocator>& rhs );	比较二个无序容器的内容。若下列条件成立则二个无序容器 lhs 与 rhs 相等：lhs.size() ==== rhs.size()从 lhs.equal_range(lhs_eq1) 获得的每组等价元素 [lhs_eq1, lhs_eq2) 拥有在另一容器中从 rhs.equal_range(rhs_eq1) 获得的对应等价元素组 [rhs_eq1, rhs_eq2) ，且它们拥有下列属性：std::distance(lhs_eq1, lhs_eq2) == == std::distance(rhs_eq1, rhs_eq2) 。std::is_permutation(lhs_eq1, lhs_eq2, rhs_eq1) == true 。
template< class Key, class T, class Hash, class KeyEqual, class Alloc >void swap( std::unordered_map<Key,T,Hash,KeyEqual,Alloc>& lhs, std::unordered_map<Key,T,Hash,KeyEqual,Alloc>& rhs );	为 std::unordered_map 特化 std::swap 算法。交换 lhs 与 rhs 的内容。调用 lhs.swap(rhs) 。

#include <iostream>
#include <unordered_map>

using namespace std;

int main()
{
    
    unordered_map<int, string> m1 = { {1,"This"},{2,"is"},{3,"an"},{4,"apple"},{5,"summer"} };

    unordered_map<int, string> m2 = { {1,"This"} };


    bool tag = (m1 == m2) ? true : false;
    cout << tag;

    swap(m1, m2);

    cout << "m1---------------" << endl;
    for (auto it = m1.begin(); it != m1.end(); it++)
    {
        cout << it->first << "-->" << it->second << endl;
    }
    
    cout << "m2---------------" << endl;
    for (auto it = m2.begin(); it != m2.end(); it++)
    {
        cout << it->first << "-->" << it->second << endl;
    }

    return 0;
}

END!!!