Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Python3.x】Del::__hash__()メソッドの使い方

__hash__メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

__hash__メソッドは、オブジェクトの一意なハッシュ値を計算して返すメソッドです。このハッシュ値は、オブジェクトを効率的に識別するための整数値であり、主にPythonのdict(辞書)のキーやset(集合)の要素としてオブジェクトを利用する際に必要とされます。ハッシュ値を用いることで、これらのデータ構造は非常に高速な要素の検索や追加、削除を実現します。

オブジェクトがハッシュ値を持てるかどうかは「ハッシュ可能(hashable)」であるかどうかに依存します。ハッシュ可能なオブジェクトは、その値が不変(immutable)であるという特徴を持っています。例えば、整数、浮動小数点数、文字列、タプルといった組み込み型はハッシュ可能です。これらのオブジェクトは一度作成されると内容が変更されないため、常に同じハッシュ値を返すことが保証されます。

一方で、リストや辞書のように内容が作成後に変更されうる(mutable)オブジェクトは、デフォルトではハッシュ不可能であり、dictのキーやsetの要素として直接使用することはできません。

自身でクラスを定義する際、もしそのインスタンスをdictのキーなどに使いたい場合は、__hash__メソッドを適切に実装する必要があります。特に、__eq__メソッド(オブジェクトの同等性を定義するメソッド)をオーバーライドする際には注意が必要です。Pythonの規約として、「a == bが真であるならば、hash(a) == hash(b)もまた真でなければならない」という重要な要件があります。この原則に反すると、dictやsetが正しく動作しなくなる可能性があるため、実装時には慎重な考慮が求められます。

構文(syntax)

1class MyHashableObject:
2    def __init__(self, identifier, name):
3        self._identifier = identifier
4        self._name = name
5
6    def __eq__(self, other):
7        if not isinstance(other, MyHashableObject):
8            return NotImplemented
9        return self._identifier == other._identifier and self._name == other._name
10
11    def __hash__(self):
12        return hash((self._identifier, self._name))

引数(parameters)

self, /

  • self: このオブジェクト自身

戻り値(return)

int

このメソッドは、オブジェクトのハッシュ値を整数型(int)で返します。ハッシュ値とは、オブジェクトを一意に識別するための一連の数値のことです。

関連コンテンツ

関連プログラミング言語