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

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

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

作成日: 更新日:

基本的な使い方

__hash__メソッドは、オブジェクトのハッシュ値を計算して返すメソッドです。ハッシュ値とは、オブジェクトを一意に識別するために使われる整数値のことで、主に辞書(dict)のキーや集合(set)の要素としてオブジェクトを扱う際に利用されます。

このメソッドが定義されているオブジェクトは「ハッシュ可能(hashable)」であると見なされます。ハッシュ可能なオブジェクトは、その生存期間を通じてハッシュ値が変化しないという特性を持つ必要があります。これは、オブジェクトが辞書や集合に追加された後でハッシュ値が変わってしまうと、正しく検索できなくなるためです。

__hash__メソッドは、__eq__メソッド(オブジェクトの等価性を比較するメソッド)と密接に関連しています。Pythonの基本的なルールとして、「もし二つのオブジェクトが等しい(a == bが真)ならば、それらのハッシュ値も等しくなければならない(hash(a) == hash(b)が真)」という一貫性が求められます。

Pythonの組み込み型では、文字列(str)、タプル(tuple)、数値型(int、floatなど)などがデフォルトでハッシュ可能です。一方で、リスト(list)や辞書(dict)のように内容が変更可能な(ミュータブルな)オブジェクトは、通常はハッシュ可能ではありません。独自のクラスで等価性比較のための__eq__メソッドを定義する場合は、この__hash__メソッドも適切に定義し、前述の一貫性のルールを守ることが重要です。

構文(syntax)

1class MyObject:
2    def __hash__(self):
3        return hash(self.immutable_attribute)

引数(parameters)

self: BinOp, /

  • self: BinOp: メソッドが呼び出されるBinOpオブジェクト自身

戻り値(return)

int

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

関連コンテンツ

関連プログラミング言語