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

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

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

作成日: 更新日:

基本的な使い方

__ne__メソッドは、Pythonにおいて二つのオブジェクトが「等しくない」かどうかを比較する際に内部的に呼び出される特殊メソッドです。具体的には、プログラム内で != (不等価) 演算子が使用されたときに、このメソッドが実行され、その結果として True または False が返されます。

このメソッドは「マジックメソッド」または「Dunderメソッド」とも呼ばれ、Pythonのオブジェクト指向プログラミングにおいて、特定の演算子の振る舞いをカスタマイズするために用いられます。Pythonの全てのクラスが継承する基底クラスである object クラスには、デフォルトの __ne__ メソッドが定義されています。このデフォルトの挙動では、通常、比較対象の二つのオブジェクトの識別子(メモリ上のアドレス)が異なる場合に True を返し、同じインスタンスを指している場合は False を返します。つまり、デフォルトではオブジェクトの同一性を基準に「等しくない」かを判断します。

しかし、クラスを定義する開発者は、この __ne__ メソッドをオーバーライド(上書き)することで、オブジェクトの内容に基づいたカスタムな「等しくない」比較ロジックを実装できます。例えば、二つの Person オブジェクトが名前と年齢のどちらかでも異なる場合に「等しくない」と判断するような、具体的なビジネスロジックを反映させることが可能です。

この __ne__ メソッドは、AsyncFunctionDef クラス(Pythonの抽象構文木において、async def で定義された非同期関数を表すクラス)のような、Pythonのあらゆる種類のオブジェクトが持つ可能性があり、オブジェクトの比較処理を柔軟に制御するために広く利用されています。これにより、プログラムの意図に合わせた正確なオブジェクト間の比較判断を実現できます。

構文(syntax)

1class MyCustomObject:
2    def __init__(self, value):
3        self.value = value
4
5    def __ne__(self, other):
6        """
7        この特殊メソッドは、オブジェクトが '!=' (等しくない) 演算子で比較されたときに呼び出されます。
8        """
9        if not isinstance(other, MyCustomObject):
10            return NotImplemented
11        return self.value != other.value
12
13# __ne__ メソッドが '!=' 演算子によって呼び出される構文
14obj_a = MyCustomObject(10)
15obj_b = MyCustomObject(20)
16obj_c = MyCustomObject(10)
17
18are_not_equal_ab = (obj_a != obj_b) # obj_a と obj_b を比較 (結果は True)
19are_not_equal_ac = (obj_a != obj_c) # obj_a と obj_c を比較 (結果は False)

引数(parameters)

self, value, /

  • self: 比較対象となるAsyncFunctionDefオブジェクト自身
  • value: 比較対象となる値

戻り値(return)

bool

2つのAsyncFunctionDefオブジェクトが等しくない場合にTrueを返します。

関連コンテンツ

関連プログラミング言語