Python hash() Function

Spread the love

The hash() function in Python takes a single argument and returns the hash value of that argument. This function is used to create a unique identifier for dictionary keys for quick data retrieval.


The syntax of the hash() function is straightforward:


Where object is the item for which you want to obtain the hash value.

Properties of hash()

The hash value of an object has a few important properties:

  • The hash of an object is an integer.
  • If two objects compare as equal (such as using the == operator), their hashes are also equal.
  • For a given object, the hash() function must return the same value during its lifetime, where “lifetime” refers to the time an object exists in memory during the execution of the program. However, across different runs of the program, the hash value may vary—even for the same object.

How the hash() Function Works

When you call hash() on an object, Python attempts to return its hash value. This is achieved by calling the __hash__() method of the object. All of Python’s immutable built-in objects are hashable, while mutable containers (like lists or dictionaries) are not, because their hash would change if their contents were altered, breaking the rule that the hash value of an object should not change over its lifetime.

The Role of Hash in Python Dictionaries

Python dictionaries use hash tables to provide fast access to their items. When you use an object as a key in a dictionary, Python uses the hash of the key to find where the value is stored. This is why only hashable objects can be used as keys in Python dictionaries.

Applications of hash()

The hash() function has a range of applications:

Unique Identifiers

Hash values can serve as unique identifiers for objects. This is useful in caching scenarios or when checking for object equality.

Data Integrity

Hash values are used to verify the integrity of data during transmission. By comparing hash values before and after data transfer, one can check if the data has been altered.

Hash Tables and Dictionaries

As mentioned, hash values are integral to the implementation of hash tables, which underpin Python dictionaries.

Security and Cryptography

Hashing is used in cryptography to create fingerprints of data. Python’s hash() function is not suitable for cryptographic purposes, but understanding basic hashing is a stepping stone towards using cryptographic hash functions provided by libraries like hashlib.

Examples of Using hash()

Let’s look at some examples of using the hash() function.

Basic Hashing:

name = "Python"
hash_value = hash(name)
print(hash_value)  # This will output the hash value for the string "Python"

Here’s what happens in this code:

  1. A string object name is created with the value "Python".
  2. The hash() function is called with the string name as the argument. Python internally calls the __hash__() method of the string object name to calculate the hash value. This hash value is a unique integer (within the current running Python process) that corresponds to the value "Python".
  3. The hash value is then stored in the variable hash_value.
  4. The print() function is used to output the hash value to the console.

Why Use Hashing?

Hash values are used primarily to compare keys quickly during dictionary or set operations. For example, if you want to check if "Python" is a key in a dictionary, Python will hash "Python", use the hash value to find the potential entry quickly, and then check for equality to confirm the match.

Hash Values and Object Equality

It is important to note that if two objects are equal (as determined by the == operator), then their hash values must also be equal. However, two objects with the same hash value are not necessarily equal, due to the possibility of hash collisions (where different values produce the same hash value).

Hashing a Tuple with hash():

The hash() function can be used with a tuple just like it can with any other immutable object. When you call hash() on a tuple, Python computes a hash value based on the contents of the tuple.

Here is an example of hashing a tuple:

my_tuple = (1, 2, 3)
print(hash(my_tuple))  # Outputs a hash value for the tuple (1, 2, 3)

In this example:

  1. A tuple named my_tuple is created with three integer elements: 1, 2, and 3.
  2. The hash() function is called with my_tuple as its argument. Python then uses the __hash__() method that is inherent to the tuple object to calculate the hash value.
  3. The calculated hash value is returned and printed to the console.

How Does Python Hash a Tuple?

The hash of a tuple is calculated in such a way that it is derived from the hashes of its contents, taking into account the order of items to ensure that two tuples with the same items in a different order will have different hash values. This is necessary because tuples are ordered, and two tuples with the same items in a different order are considered different.

For example:

tuple_a = (1, 2, 3)
tuple_b = (3, 2, 1)
print(hash(tuple_a) == hash(tuple_b))  # Outputs False

tuple_a and tuple_b have the same elements but in a different order, resulting in different hash values.

Restrictions on Tuple Contents

Not all tuples can be hashed. If a tuple contains mutable objects like lists, it cannot be hashed because its contents can change, violating the requirement that a hashable object must have a hash value that does not change over its lifetime.

tuple_with_list = (1, 2, [3, 4])
print(hash(tuple_with_list))  # Raises a TypeError

Here, attempting to hash tuple_with_list will raise a TypeError because lists are not hashable.

Attempting to Hash a List (which will fail)

When you try to obtain the hash of a list, Python raises a TypeError. Here’s an example:

my_list = [1, 2, 3]
print(hash(my_list))  # This will raise a TypeError

Attempting to run the code above will give you an error message like this:

TypeError: unhashable type: 'list'

This error is Python’s way of telling you that it cannot perform the operation because lists are not designed to have a fixed hash value.

Behind the Scenes

When hash() is called on an object, Python looks for a __hash__() method on the object, which should return an integer value that represents the hash. Since lists are designed to be mutable, they intentionally do not have a __hash__() method. This lack of a __hash__() method is what causes Python to raise a TypeError when you try to hash a list.

Implications of Non-Hashable Objects

The inability to hash a list directly impacts how you can use lists in your code, particularly with sets and dictionaries. If you need a collection of items to use as a dictionary key or a set element, you would typically use a tuple instead of a list, precisely because tuples are immutable and hashable.


If you find yourself needing to use a list-like object as a dictionary key, you must first convert it to an immutable form. The common practice is to convert the list to a tuple, which can then be hashed:

my_list = [1, 2, 3]
my_tuple = tuple(my_list)
print(hash(my_tuple))  # Outputs a hash value for the tuple (1, 2, 3)

In this workaround, my_tuple is a tuple representation of my_list, and it can be hashed successfully.

Best Practices When Using hash()

  • Use hash() only with immutable objects if the hash value needs to persist across program executions.
  • Do not use Python’s hash() for cryptographic purposes; instead, use a library like hashlib that is designed for such use cases.
  • Remember that hash collisions can occur, so never assume that different objects cannot have the same hash value.

Limitations and Considerations of hash()

The hash() function is not infallible:

  • Collisions: Different objects can have the same hash value. This is due to the pigeonhole principle—there are more possible input objects than possible hash values.
  • Security: Python’s default hash() is not secure against collision attacks and should not be used for security-sensitive applications.
  • Persistence: As of Python 3.3, the hash of an object is randomized between different executions of a program for security reasons related to hash collision attacks in web applications.


The hash() function is an essential component of Python’s capabilities, deeply integrated into the language’s handling of collections and providing the backbone for high-performance, memory-efficient data structures. By mastering hash(), developers can ensure that their use of Python dictionaries and sets is optimal, and they can also apply the concepts of hashing to a variety of other practical programming challenges.

Despite its limitations, such as susceptibility to collisions and lack of suitability for cryptographic purposes, hash() serves its designed purpose admirably, offering Python programmers a built-in, easy-to-use tool for generating hash values of immutable objects.

Leave a Reply