公有成员函数 (public member function)
<unordered_map>

std:: unordered_map ::rehash

void rehash( size_type n );
设置桶的数量
将容器中的桶数设置为 n 或更多。

如果 n 大于容器中当前的桶数 (bucket_count),则强制进行重新散列。新的 桶数 可以等于或大于 n

如果 n 小于容器中当前的桶数 (bucket_count),则该函数可能不会影响 桶数 并且可能不会强制进行重新散列。

一个 重新散列 是哈希表的重建:容器中的所有元素根据其哈希值重新排列到新的桶集中。这可能会改变容器中元素的迭代顺序。

当容器的 负载因子 即将超过其 最大负载因子 时,容器会自动执行重新散列。

请注意,此函数将桶数作为参数。存在一个类似的函数 unordered_map::reserve,它以容器中的元素数量作为参数。

参数

n
容器哈希表的最小桶数。
成员类型size_type是一种无符号整型类型。

返回值



示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// unordered_map::rehash
#include <iostream>
#include <string>
#include <unordered_map>

int main ()
{
  std::unordered_map<std::string,std::string> mymap;

  mymap.rehash(20);

  mymap["house"] = "maison";
  mymap["apple"] = "pomme";
  mymap["tree"] = "arbre";
  mymap["book"] = "livre";
  mymap["door"] = "porte";
  mymap["grapefruit"] = "pamplemousse";

  std::cout << "current bucket_count: " << mymap.bucket_count() << std::endl;

  return 0;
}

可能的输出
current bucket_count: 23


通过调用rehash (重新散列)通过预留一定数量的最小桶数到哈希表中,我们可以避免容器扩展可能引起的多次重新散列。

复杂度

在重新哈希的情况下,
平均情况:与 容器大小 线性相关。
最坏情况:与 容器大小 二次相关。

迭代器有效性

如果发生重新哈希,所有迭代器都会失效,但指向单个元素的引用和指针仍然有效。
如果没有实际发生重新哈希,则无变化。

另见