Menu
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP HOW TO W3.CSS C C++ C# BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS DSA TYPESCRIPT ANGULAR GIT POSTGRESQL MONGODB ASP AI R GO KOTLIN SASS VUE GEN AI SCIPY CYBERSECURITY DATA SCIENCE INTRO TO PROGRAMMING BASH RUST

Python Tutorial

Python HOME Python Intro Python Get Started Python Syntax Python Comments Python Variables Python Data Types Python Numbers Python Casting Python Strings Python Booleans Python Operators Python Lists Python Tuples Python Sets Python Dictionaries Python If...Else Python Match Python While Loops Python For Loops Python Functions Python Lambda Python Arrays Python Classes/Objects Python Inheritance Python Iterators Python Polymorphism Python Scope Python Modules Python Dates Python Math Python JSON Python RegEx Python PIP Python Try...Except Python String Formatting Python User Input Python VirtualEnv

File Handling

Python File Handling Python Read Files Python Write/Create Files Python Delete Files

Python Modules

NumPy Tutorial Pandas Tutorial SciPy Tutorial Django Tutorial

Python Matplotlib

Matplotlib Intro Matplotlib Get Started Matplotlib Pyplot Matplotlib Plotting Matplotlib Markers Matplotlib Line Matplotlib Labels Matplotlib Grid Matplotlib Subplot Matplotlib Scatter Matplotlib Bars Matplotlib Histograms Matplotlib Pie Charts

Machine Learning

Getting Started Mean Median Mode Standard Deviation Percentile Data Distribution Normal Data Distribution Scatter Plot Linear Regression Polynomial Regression Multiple Regression Scale Train/Test Decision Tree Confusion Matrix Hierarchical Clustering Logistic Regression Grid Search Categorical Data K-means Bootstrap Aggregation Cross Validation AUC - ROC Curve K-nearest neighbors

Python DSA

Python DSA Lists and Arrays Stacks Queues Linked Lists Hash Tables Trees Binary Trees Binary Search Trees AVL Trees Graphs Linear Search Binary Search Bubble Sort Selection Sort Insertion Sort Quick Sort Counting Sort Radix Sort Merge Sort

Python MySQL

MySQL Get Started MySQL Create Database MySQL Create Table MySQL Insert MySQL Select MySQL Where MySQL Order By MySQL Delete MySQL Drop Table MySQL Update MySQL Limit MySQL Join

Python MongoDB

MongoDB Get Started MongoDB Create DB MongoDB Collection MongoDB Insert MongoDB Find MongoDB Query MongoDB Sort MongoDB Delete MongoDB Drop Collection MongoDB Update MongoDB Limit

Python Reference

Python Overview Python Built-in Functions Python String Methods Python List Methods Python Dictionary Methods Python Tuple Methods Python Set Methods Python File Methods Python Keywords Python Exceptions Python Glossary

Module Reference

Random Module Requests Module Statistics Module Math Module cMath Module

Python How To

Remove List Duplicates Reverse a String Add Two Numbers

Python Examples

Python Examples Python Compiler Python Exercises Python Quiz Python Server Python Syllabus Python Study Plan Python Interview Q&A Python Bootcamp Python Certificate Python Training

Hash Tables with Python


Hash Table

A Hash Table is a data structure designed to be fast to work with.

The reason Hash Tables are sometimes preferred instead of arrays or linked lists is because searching for, adding, and deleting data can be done really quickly, even for large amounts of data.

In a Linked List, finding a person "Bob" takes time because we would have to go from one node to the next, checking each node, until the node with "Bob" is found.

And finding "Bob" in an list/array could be fast if we knew the index, but when we only know the name "Bob", we need to compare each element and that takes time.

With a Hash Table however, finding "Bob" is done really fast because there is a way to go directly to where "Bob" is stored, using something called a hash function.


Building A Hash Table from Scratch

To get the idea of what a Hash Table is, let's try to build one from scratch, to store unique first names inside it.

We will build the Hash Table in 5 steps:

  1. Create an empty list (it can also be a dictionary or a set).
  2. Create a hash function.
  3. Inserting an element using a hash function.
  4. Looking up an element using a hash function.
  5. Handling collisions.

Step 1: Create an Empty List

To keep it simple, let's create a list with 10 empty elements.

my_list = [None, None, None, None, None, None, None, None, None, None]

Each of these elements is called a bucket in a Hash Table.


Step 2: Create a Hash Function

Now comes the special way we interact with Hash Tables.

We want to store a name directly into its right place in the array, and this is where the hash function comes in.

A hash function can be made in many ways, it is up to the creator of the Hash Table. A common way is to find a way to convert the value into a number that equals one of the Hash Table's index numbers, in this case a number from 0 to 9.

In our example we will use the Unicode number of each character, summarize them and do a modulo 10 operation to get index numbers 0-9.

Example

Create a Hash Function that sums the Unicode numbers of each character and return a number between 0 and 9:

def hash_function(value):
  sum_of_chars = 0
  for char in value:
    sum_of_chars += ord(char)

  return sum_of_chars % 10

print("'Bob' has hash code:", hash_function('Bob'))
Try it yourself »

The character B has Unicode number 66, o has 111, and b has 98. Adding those together we get 275. Modulo 10 of 275 is 5, so "Bob" should be stored at index 5.

The number returned by the hash function is called the hash code.

Unicode number: Everything in our computers are stored as numbers, and the Unicode code number is a unique number that exist for every character. For example, the character A has Unicode number 65.

See this page for more information about how characters are represented as numbers.

Modulo: A modulo operation divides a number with another number, and gives us the resulting remainder. So for example, 7 % 3 will give us the remainder 1. (Dividing 7 apples between 3 people, means that each person gets 2 apples, with 1 apple to spare.)

In Python and most programming languages, the modolo operator is written as %.


Step 3: Inserting an Element

According to our hash function, "Bob" should be stored at index 5.

Lets create a function that add items to our hash table:

Example

def add(name):
  index = hash_function(name)
  my_list[index] = name

add('Bob')
print(my_list)
Run Example »

After storing "Bob" at index 5, our array now looks like this:

my_list = [None, None, None, None, None, 'Bob', None, None, None, None]

We can use the same functions to store "Pete", "Jones", "Lisa", and "Siri" as well.

Example

add('Pete')
add('Jones')
add('Lisa')
add('Siri')
print(my_list)
Run Example »

After using the hash function to store those names in the correct position, our array looks like this:

Example

my_list = [None, 'Jones', None, 'Lisa', None, 'Bob', None, 'Siri', 'Pete', None]

Step 4: Looking up a name

Now that we have a super basic Hash Table, let's see how we can look up a name from it.

To find "Pete" in the Hash Table, we give the name "Pete" to our hash function. The hash function returns 8, meaning that "Pete" is stored at index 8.

Example

def contains(name):
  index = hash_function(name)
  return my_list[index] == name

print("'Pete' is in the Hash Table:", contains('Pete'))
Run Example »

Because we do not have to check element by element to find out if "Pete" is in there, we can just use the hash function to go straight to the right element!


Step 5: Handling collisions

Let's also add "Stuart" to our Hash Table.

We give "Stuart" to our hash function, which returns 3, meaning "Stuart" should be stored at index 3.

Trying to store "Stuart" in index 3, creates what is called a collision, because "Lisa" is already stored at index 3.

To fix the collision, we can make room for more elements in the same bucket. Solving the collision problem in this way is called chaining, and means giving room for more elements in the same bucket.

Start by creating a new list with the same size as the original list, but with empty buckets:

my_list = [
  [],
  [],
  [],
  [],
  [],
  [],
  [],
  [],
  [],
  []
]

Rewrite the add() function, and add the same names as before:

Example

def add(name):
  index = hash_function(name)
  my_list[index].append(name)

add('Bob')
add('Pete')
add('Jones')
add('Lisa')
add('Siri')
add('Stuart')
print(my_list)
Run Example »

After implementing each bucket as a list, "Stuart" can also be stored at index 3, and our Hash Set now looks like this:

Result

my_list = [
  [None],
  ['Jones'],
  [None],
  ['Lisa', 'Stuart'],
  [None],
  ['Bob'],
  [None],
  ['Siri'],
  ['Pete'],
  [None]
]

Searching for "Stuart" now takes a little bit longer time, because we also find "Lisa" in the same bucket, but still much faster than searching the entire Hash Table.


Uses of Hash Tables

Hash Tables are great for:

  • Checking if something is in a collection (like finding a book in a library).
  • Storing unique items and quickly finding them (like storing phone numbers).
  • Connecting values to keys (like linking names to phone numbers).

The most important reason why Hash Tables are great for these things is that Hash Tables are very fast compared Arrays and Linked Lists, especially for large sets. Arrays and Linked Lists have time complexity O(n) for search and delete, while Hash Tables have just O(1) on average.


Hash Tables Summarized

Hash Table elements are stored in storage containers called buckets.

A hash function takes the key of an element to generate a hash code.

The hash code says what bucket the element belongs to, so now we can go directly to that Hash Table element: to modify it, or to delete it, or just to check if it exists.

A collision happens when two Hash Table elements have the same hash code, because that means they belong to the same bucket.

Collision can be solved by Chaining by using lists to allow more than one element in the same bucket.


×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookie and privacy policy.

Copyright 1999-2025 by Refsnes Data. All Rights Reserved. W3Schools is Powered by W3.CSS.