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

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

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

作成日: 更新日:

基本的な使い方

__hash__メソッドは、Pythonのオブジェクトのハッシュ値を計算するために実行されるメソッドです。このメソッドは、組み込み関数であるhash()がオブジェクトのハッシュ値を取得する際に内部的に呼び出されます。ハッシュ値とは、オブジェクトを一意に識別するための整数値であり、特に辞書(dict)のキーや集合(set)の要素としてオブジェクトを使用する際に重要な役割を果たします。

辞書のキーや集合の要素として利用できるオブジェクトは「ハッシュ可能(hashable)」である必要があります。ハッシュ可能なオブジェクトは、その生存期間中にハッシュ値が変化しないこと、および、等しいと判断される(__eq__メソッドによってTrueが返される)オブジェクト同士は常に同じハッシュ値を持つこと、という二つの主要な条件を満たす必要があります。これらの条件が満たされない場合、辞書や集合が期待通りに動作しない可能性があります。

Pythonでは、デフォルトで定義される多くのオブジェクト、例えば数値型や文字列型、タプル型などはハッシュ可能です。一方で、リストや辞書のような内容が変更されうる「可変(mutable)」なオブジェクトは、原則としてハッシュ可能ではありません。

システムエンジニアを目指す皆様がカスタムクラスを作成する際、そのインスタンスを辞書のキーや集合の要素として使いたい場合は、この__hash__メソッドと__eq__メソッドを適切に実装またはオーバーライドすることが求められます。これにより、作成したオブジェクトがハッシュ可能となり、ハッシュベースのデータ構造を効率的かつ正確に利用できるようになります。

構文(syntax)

1class MyObject:
2    def __hash__(self):
3        # オブジェクトのハッシュ値を計算し、整数を返します。
4        # 通常、オブジェクトの不変な属性に基づいてハッシュ値を計算します。
5        return hash(self.identifier)

引数(parameters)

self: object

  • self: object: ハッシュ化されるオブジェクト自身

戻り値(return)

int

hash メソッドは、オブジェクトのハッシュ値を整数型 (int) で返します。このハッシュ値は、辞書や集合などのデータ構造でオブジェクトを一意に識別するために使用されます。

関連コンテンツ

関連プログラミング言語