# Hash table

In computer science, a hash table is a data structure that implements an associative array, also called a dictionary or simply map; an associative array is an abstract data type that maps keys to values. A hash table uses a hash function to compute an index, also called a hash code, into an array of buckets or slots, from which the desired value can be found. During lookup, the key is hashed and the resulting hash indicates where the corresponding value is stored. A map implemented by a hash table is called a hash map.
Most hash table designs employ an imperfect hash function. Hash collisions, where the hash function generates the same index for more than one key, therefore typically must be accommodated in some way.
In a well-dimensioned hash table, the average time complexity for each lookup is independent of the number of elements stored in the table. Many hash table designs also allow arbitrary insertions and deletions of key–value pairs, at amortized constant average cost per operation.
Hashing is an example of a space-time tradeoff. If memory is infinite, the entire key can be used directly as an index to locate its value with a single memory access. On the other hand, if infinite time is available, values can be stored without regard for their keys, and a binary search or linear search can be used to retrieve the element.$^{:458}$
In many situations, hash tables turn out to be on average more efficient than search trees or any other table lookup structure. For this reason, they are widely used in many kinds of computer software, particularly for associative arrays, database indexing, caches, and sets.

## History

The idea of hashing arose independently in different places. In January 1953, Hans Peter Luhn wrote an internal IBM memorandum that used hashing with chaining. The first example of open addressing was proposed by A. D. Linh, building on Luhn's memorandum.$^{:547}$ Around the same time, Gene Amdahl, Elaine M. McGraw, Nathaniel Rochester, and Arthur Samuel of IBM Research implemented hashing for the IBM 701 assembler.$^{:124}$ Open addressing with linear probing is credited to Amdahl, although Andrey Ershov independently had the same idea.$^{:124–125}$ The term "open addressing" was coined by W. Wesley Peterson in his article which discusses the problem of search in large files.$^{:15}$
The first published work on hashing with chaining is credited to Arnold Dumey, who discussed the idea of using remainder modulo a prime as a hash function.$^{:15}$ The word "hashing" was first published in an article by Robert Morris.$^{:126}$ A theoretical analysis of linear probing was submitted originally by Konheim and Weiss.$^{:15}$

## Overview

An associative array stores a set of (key, value) pairs and allows insertion, deletion, and lookup (search), with the constraint of unique keys. In the hash table implementation of associative arrays, an array $A$ of length $m$ is partially filled with $n$ elements, where $m\geq n$. A key $x$ is hashed using a hash function $h$ to compute an index location $A[h(x)]$ in the hash table, where $h(x)<m$. At this index, both the key and its associated value are stored. Storing the key alongside the value ensures that lookups can verify the key at the index to retrieve the correct value, even in the presence of collisions. Under reasonable assumptions, hash tables have better time complexity bounds on search, delete, and insert operations in comparison to self-balancing binary search trees.$^{:1}$
Hash tables are also commonly used to implement sets, by omitting the stored value for each key and merely tracking whether the key is present.$^{:1}$

### Load factor

A load factor $\alpha$ is a critical statistic of a hash table, and is defined as follows: ${\text{load factor}}\ (\alpha )={\frac {n}{m}},$ where
* $n$ is the number of entries occupied in the hash table.
* $m$ is the number of buckets.
The performance of the hash table deteriorates in relation to the load factor $\alpha$.$^{:2}$
The software typically ensures that the load factor $\alpha$ remains below a certain constant, $\alpha _{\max }$. This helps maintain good performance. Therefore, a common approach is to resize or "rehash" the hash table whenever the load factor $\alpha$ reaches $\alpha _{\max }$. Similarly the table may also be resized if the load factor drops below $\alpha _{\max }/4$.

#### Load factor for separate chaining

With separate chaining hash tables, each slot of the bucket array stores a pointer to a list or array of data.
Separate chaining hash tables suffer gradually declining performance as the load factor grows, and no fixed point beyond which resizing is absolutely needed.
With separate chaining, the value of $\alpha _{\max }$ that gives best performance is typically between 1 and 3.

#### Load factor for open addressing

With open addressing, each slot of the bucket array holds exactly one item. Therefore an open-addressed hash table cannot have a load factor greater than 1.
The performance of open addressing becomes very bad when the load factor approaches 1.
Therefore a hash table that uses open addressing must be resized or rehashed if the load factor $\alpha$ approaches 1.
With open addressing, acceptable figures of max load factor $\alpha _{\max }$ should range around 0.6 to 0.75.$^{:110}$

## Hash function

A hash function $h:U\rightarrow \{0,...,m-1\}$ maps the universe $U$ of keys to indices or slots within the table, that is, $h(x)\in \{0,...,m-1\}$ for $x\in U$. The conventional implementations of hash functions are based on the integer universe assumption that all elements of the table stem from the universe $U=\{0,...,u-1\}$, where the bit length of $u$ is confined within the word size of a computer architecture.$^{:2}$
A hash function $h$ is said to be perfect for a given set $S$ if it is injective on $S$, that is, if each element $x\in S$ maps to a different value in ${0,...,m-1}$. A perfect hash function can be created if all the keys are known ahead of time.

### Integer universe assumption

The schemes of hashing used in integer universe assumption include hashing by division, hashing by multiplication, universal hashing, dynamic perfect hashing, and static perfect hashing.$^{:2}$ However, hashing by division is the commonly used scheme.$^{:264}$$^{:110}$

#### Hashing by division

The scheme in hashing by division is as follows:$^{:2}$ $h(x)\ =\ x\,{\bmod {\,}}m$ where $h(x)$ is the hash value of $x\in S$ and $m$ is the size of the table.

#### Hashing by multiplication

The scheme in hashing by multiplication is as follows:$^{:2–3}$ $h(x)=\lfloor m{\bigl(xA){\bmod {1}}{\bigr )}\rfloor$ Where $A$ is a non-integer real-valued constant and $m$ is the size of the table. An advantage of the hashing by multiplication is that the $m$ is not critical.$^{:2–3}$ Although any value $A$ produces a hash function, Donald Knuth suggests using the golden ratio.$^{:3}$

### Choosing a hash function

Uniform distribution of the hash values is a fundamental requirement of a hash function. A non-uniform distribution increases the number of collisions and the cost of resolving them. Uniformity is sometimes difficult to ensure by design, but may be evaluated empirically using statistical tests, e.g., a Pearson's chi-squared test for discrete uniform distributions.
The distribution needs to be uniform only for table sizes that occur in the application. In particular, if one uses dynamic resizing with exact doubling and halving of the table size, then the hash function needs to be uniform only when the size is a power of two. Here the index can be computed as some range of bits of the hash function. On the other hand, some hashing algorithms prefer to have the size be a prime number.
For open addressing schemes, the hash function should also avoid clustering, the mapping of two or more keys to consecutive slots. Such clustering may cause the lookup cost to skyrocket, even if the load factor is low and collisions are infrequent. The popular multiplicative hash is claimed to have particularly poor clustering behavior.
K-independent hashing offers a way to prove a certain hash function does not have bad keysets for a given type of hashtable. A number of K-independence results are known for collision resolution schemes such as linear probing and cuckoo hashing. Since K-independence can prove a hash function works, one can then focus on finding the fastest possible such hash function.

## Collision resolution

A search algorithm that uses hashing consists of two parts. The first part is computing a hash function which transforms the search key into an array index. The ideal case is such that no two search keys hashes to the same array index. However, this is not always the case and is impossible to guarantee for unseen given data.$^{:515}$ Hence the second part of the algorithm is collision resolution. The two common methods for collision resolution are separate chaining and open addressing.$^{:458}$

### Separate chaining

In separate chaining, the process involves building a linked list with key–value pair for each search array index. The collided items are chained together through a single linked list, which can be traversed to access the item with a unique search key.$^{:464}$ Collision resolution through chaining with linked list is a common method of implementation of hash tables. Let $T$ and $x$ be the hash table and the node respectively, the operation involves as follows:$^{:258}$
If the element is comparable either numerically or lexically, and inserted into the list by maintaining the total order, it results in faster termination of the unsuccessful searches.$^{:520–521}$

#### Other data structures for separate chaining

If the keys are ordered, it could be efficient to use "self-organizing" concepts such as using a self-balancing binary search tree, through which the theoretical worst case could be brought down to $O(\log {n})$, although it introduces additional complexities.$^{:521}$
In dynamic perfect hashing, two-level hash tables are used to reduce the look-up complexity to be a guaranteed $O(1)$ in the worst case. In this technique, the buckets of $k$ entries are organized as perfect hash tables with $k^{2}$ slots providing constant worst-case lookup time, and low amortized time for insertion. A study shows array-based separate chaining to be 97% more performant when compared to the standard linked list method under heavy load.$^{:99}$
Techniques such as using fusion tree for each buckets also result in constant time for all operations with high probability.

#### Caching and locality of reference

The linked list of separate chaining implementation may not be cache-conscious due to spatial locality—locality of reference—when the nodes of the linked list are scattered across memory, thus the list traversal during insert and search may entail CPU cache inefficiencies.$^{:91}$
In cache-conscious variants of collision resolution through separate chaining, a dynamic array found to be more cache-friendly is used in the place where a linked list or self-balancing binary search trees is usually deployed, since the contiguous allocation pattern of the array could be exploited by hardware-cache prefetchers—such as translation lookaside buffer—resulting in reduced access time and memory consumption.

### Open addressing

Open addressing is another collision resolution technique in which every entry record is stored in the bucket array itself, and the hash resolution is performed through probing. When a new entry has to be inserted, the buckets are examined, starting with the hashed-to slot and proceeding in some probe sequence, until an unoccupied slot is found. When searching for an entry, the buckets are scanned in the same sequence, until either the target record is found, or an unused array slot is found, which indicates an unsuccessful search.
Well-known probe sequences include:
* Linear probing, in which the interval between probes is fixed (usually 1).
* Quadratic probing, in which the interval between probes is increased by adding the successive outputs of a quadratic polynomial to the value given by the original hash computation.$^{:272}$
* Double hashing, in which the interval between probes is computed by a secondary hash function.$^{:272–273}$
The performance of open addressing may be slower compared to separate chaining since the probe sequence increases when the load factor $\alpha$ approaches 1.$^{:93}$ The probing results in an infinite loop if the load factor reaches 1, in the case of a completely filled table.$^{:471}$ The average cost of linear probing depends on the hash function's ability to distribute the elements uniformly throughout the table to avoid clustering, since formation of clusters would result in increased search time.$^{:472}$

#### Caching and locality of reference

Since the slots are located in successive locations, linear probing could lead to better utilization of CPU cache due to locality of references resulting in reduced memory latency.

#### Other collision resolution techniques based on open addressing
##### Coalesced hashing

Coalesced hashing is a hybrid of both separate chaining and open addressing in which the buckets or nodes link within the table.$^{:6–8}$ The algorithm is ideally suited for fixed memory allocation.$^{:4}$ The collision in coalesced hashing is resolved by identifying the largest-indexed empty slot on the hash table, then the colliding value is inserted into that slot. The bucket is also linked to the inserted node's slot which contains its colliding hash address.$^{:8}$

##### Cuckoo hashing

Cuckoo hashing is a form of open addressing collision resolution technique which guarantees $O(1)$ worst-case lookup complexity and constant amortized time for insertions. The collision is resolved through maintaining two hash tables, each having its own hashing function, and collided slot gets replaced with the given item, and the preoccupied element of the slot gets displaced into the other hash table. The process continues until every key has its own spot in the empty buckets of the tables; if the procedure enters into infinite loop—which is identified through maintaining a threshold loop counter—both hash tables get rehashed with newer hash functions and the procedure continues.$^{:124–125}$

##### Hopscotch hashing

Hopscotch hashing is an open addressing based algorithm which combines the elements of cuckoo hashing, linear probing and chaining through the notion of a neighbourhood of buckets—the subsequent buckets around any given occupied bucket, also called a "virtual" bucket.$^{:351–352}$ The algorithm is designed to deliver better performance when the load factor of the hash table grows beyond 90%; it also provides high throughput in concurrent settings, thus well suited for implementing resizable concurrent hash table.$^{:350}$ The neighbourhood characteristic of hopscotch hashing guarantees a property that, the cost of finding the desired item from any given buckets within the neighbourhood is very close to the cost of finding it in the bucket itself; the algorithm attempts to be an item into its neighbourhood—with a possible cost involved in displacing other items.$^{:352}$
Each bucket within the hash table includes an additional "hop-information"—an H-bit bit array for indicating the relative distance of the item which was originally hashed into the current virtual bucket within H − 1 entries.$^{:352}$ Let $k$ and $Bk$ be the key to be inserted and bucket to which the key is hashed into respectively; several cases are involved in the insertion procedure such that the neighbourhood property of the algorithm is vowed:$^{:352–353}$ if $Bk$ is empty, the element is inserted, and the leftmost bit of bitmap is set to 1; if not empty, linear probing is used for finding an empty slot in the table, the bitmap of the bucket gets updated followed by the insertion; if the empty slot is not within the range of the neighbourhood, i.e. H − 1, subsequent swap and hop-info bit array manipulation of each bucket is performed in accordance with its neighbourhood invariant properties.$^{:353}$

##### Robin Hood hashing

Robin Hood hashing is an open addressing based collision resolution algorithm; the collisions are resolved through favouring the displacement of the element that is farthest—or longest probe sequence length (PSL)—from its "home location" i.e. the bucket to which the item was hashed into.$^{:12}$ Although Robin Hood hashing does not change the theoretical search cost, it significantly affects the variance of the distribution of the items on the buckets,$^{:2}$ i.e. dealing with cluster formation in the hash table. Each node within the hash table that uses Robin Hood hashing should be augmented to store an extra PSL value. Let $x$ be the key to be inserted, $x{.}{\text{psl}}$ be the (incremental) PSL length of $x$, $T$ be the hash table and $j$ be the index, the insertion procedure is as follows:$^{:12–13}$$^{:5}$
* If $x{.}{\text{psl}}\ \leq \ T[j]{.}{\text{psl}}$: the iteration goes into the next bucket without attempting an external probe.
* If $x{.}{\text{psl}}\ >\ T[j]{.}{\text{psl}}$: insert the item $x$ into the bucket $j$; swap $x$ with $T[j]$—let it be $x'$; continue the probe from the $(j+1)$th bucket to insert $x'$; repeat the procedure until every element is inserted.

## Dynamic resizing

Repeated insertions cause the number of entries in a hash table to grow, which consequently increases the load factor; to maintain the amortized $O(1)$ performance of the lookup and insertion operations, a hash table is dynamically resized and the items of the tables are rehashed into the buckets of the new hash table, since the items cannot be copied over as varying table sizes results in different hash value due to modulo operation. If a hash table becomes "too empty" after deleting some elements, resizing may be performed to avoid excessive memory usage.

### Resizing by moving all entries

Generally, a new hash table with a size double that of the original hash table gets allocated privately and every item in the original hash table gets moved to the newly allocated one by computing the hash values of the items followed by the insertion operation. Rehashing is simple, but computationally expensive.$^{:478–479}$

### Alternatives to all-at-once rehashing

Some hash table implementations, notably in real-time systems, cannot pay the price of enlarging the hash table all at once, because it may interrupt time-critical operations. If one cannot avoid dynamic resizing, a solution is to perform the resizing gradually to avoid storage blip—typically at 50% of new table's size—during rehashing and to avoid memory fragmentation that triggers heap compaction due to deallocation of large memory blocks caused by the old hash table.$^{:2–3}$ In such case, the rehashing operation is done incrementally through extending prior memory block allocated for the old hash table such that the buckets of the hash table remain unaltered. A common approach for amortized rehashing involves maintaining two hash functions $h_{\text{old}}$ and $h_{\text{new}}$. The process of rehashing a bucket's items in accordance with the new hash function is termed as cleaning, which is implemented through command pattern by encapsulating the operations such as $\mathrm {Add} (\mathrm {key} )$, $\mathrm {Get} (\mathrm {key} )$ and $\mathrm {Delete} (\mathrm {key} )$ through a $\mathrm {Lookup} (\mathrm {key} ,{\text{command}})$ wrapper such that each element in the bucket gets rehashed and its procedure involve as follows:$^{:3}$
* Clean $\mathrm {Table} [h_{\text{old}}(\mathrm {key} )]$ bucket.
* Clean $\mathrm {Table} [h_{\text{new}}(\mathrm {key} )]$ bucket.
* The command gets executed.

#### Linear hashing

Linear hashing is an implementation of the hash table which enables dynamic growths or shrinks of the table one bucket at a time.

## Performance

The performance of a hash table is dependent on the hash function's ability in generating quasi-random numbers ($\sigma$) for entries in the hash table where $K$, $n$ and $h(x)$ denotes the key, number of buckets and the hash function such that $\sigma \ =\ h(K)\ \%\ n$. If the hash function generates the same $\sigma$ for distinct keys ($K_{1}\neq K_{2},\ h(K_{1})\ =\ h(K_{2})$), this results in collision, which is dealt with in a variety of ways. The constant time complexity ($O(1)$) of the operation in a hash table is presupposed on the condition that the hash function doesn't generate colliding indices; thus, the performance of the hash table is directly proportional to the chosen hash function's ability to disperse the indices.$^{:1}$ However, construction of such a hash function is practically infeasible, that being so, implementations depend on case-specific collision resolution techniques in achieving higher performance.$^{:2}$

## Applications
### Associative arrays

Hash tables are commonly used to implement many types of in-memory tables. They are used to implement associative arrays.

### Database indexing

Hash tables may also be used as disk-based data structures and database indices (such as in dbm) although B-trees are more popular in these applications.

### Caches

Hash tables can be used to implement caches, auxiliary data tables that are used to speed up the access to data that is primarily stored in slower media. In this application, hash collisions can be handled by discarding one of the two colliding entries—usually erasing the old item that is currently stored in the table and overwriting it with the new item, so every item in the table has a unique hash value.

### Sets

Hash tables can be used in the implementation of set data structure, which can store unique values without any particular order; set is typically used in testing the membership of a value in the collection, rather than element retrieval.

### Transposition table

A transposition table to a complex Hash Table which stores information about each section that has been searched.

## Implementations

Many programming languages provide hash table functionality, either as built-in associative arrays or as standard library modules.
* In JavaScript, an "object" is a mutable collection of key-value pairs (called "properties"), where each key is either a string or a guaranteed-unique "symbol"; any other value, when used as a key, is first coerced to a string. Aside from the seven "primitive" data types, every value in JavaScript is an object. ECMAScript 2015 also added the Map data structure, which accepts arbitrary values as keys.
* C++11 includes unordered_map in its standard library for storing keys and values of arbitrary types.
* Go's built-in map implements a hash table in the form of a type.
* Java programming language includes the HashSet, HashMap, LinkedHashSet, and LinkedHashMap generic collections.
* Python's built-in dict implements a hash table in the form of a type.
* Ruby's built-in Hash uses the open addressing model from Ruby 2.4 onwards.
* Rust programming language includes HashMap, HashSet as part of the Rust Standard Library.
* The .NET standard library includes HashSet and Dictionary, so it can be used from languages such as C# and VB.NET.