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

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

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

作成日: 更新日:

基本的な使い方

__hash__メソッドは、Addクラスのインスタンスからハッシュ値を計算するために実行するメソッドです。ハッシュ値とは、オブジェクトを一意に識別するための整数値であり、Pythonの組み込みデータ構造である辞書(dict)のキーや、セット(set)の要素としてオブジェクトを使用する際に不可欠な要素となります。

Addクラスのオブジェクトが、これらのデータ構造のキーや要素として適切に機能するためには、「ハッシュ可能(hashable)」である必要があります。この「ハッシュ可能」であるかどうかの判断や、具体的なハッシュ値の算出を行うのが、この__hash__メソッドの主な役割です。

ハッシュ値にはいくつかの重要な特性があります。まず、同じ内容を持つオブジェクトからは、常に同じハッシュ値が返されなければなりません。これにより、Pythonはオブジェクトを高速に検索・比較できます。また、ハッシュ値は通常、オブジェクトが一度作成されたらその内容が変更されない「変更不可能(immutable)」な場合に定義されます。もしオブジェクトが途中で変更されるとハッシュ値も変わり、辞書やセット内で正しく追跡できなくなる可能性があるためです。したがって、Addクラスのインスタンスが不変であることを保証する場合に、この__hash__メソッドは特に重要となります。このメソッドを正確に実装することで、Addクラスのオブジェクトを効率的かつ信頼性高く利用することが可能になります。

構文(syntax)

1class Add:
2    def __init__(self, value1, value2):
3        self.value1 = value1
4        self.value2 = value2
5
6    def __hash__(self):
7        return hash((self.value1, self.value2))

引数(parameters)

self: Add, /

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

戻り値(return)

int

このメソッドは、オブジェクトのハッシュ値を示す整数を返します。ハッシュ値は、オブジェクトを辞書やセットなどのコレクションで一意に識別するために使用されます。

関連コンテンツ

関連プログラミング言語