【Python3.x】Call::__le__()メソッドの使い方
__le__メソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
__le__メソッドは、Pythonにおいてオブジェクト間の「AがB以下である」という大小関係を定義するために使用される特殊(マジック)メソッドを実行するメソッドです。これは、カスタムクラスのインスタンス同士を比較する際に、組み込みの比較演算子である <= を利用できるようにするために実装します。
例えば、独自の基準で順序付けられるオブジェクトを扱う場合、そのクラス内に__le__メソッドを定義することで、どのような条件で一方のオブジェクトがもう一方のオブジェクト以下であるかをプログラマーが明確に記述できます。Pythonのインタプリタは、二つのオブジェクトに対してobj1 <= obj2のような比較が行われた際に、内部的にobj1.__le__(obj2)を呼び出し、そのメソッドが返す真偽値(TrueまたはFalse)を比較結果として使用します。
このメソッドは通常、self(比較の左側のオブジェクト)と、比較対象となるもう一つのオブジェクト(otherなどと命名されることが多い)を引数として受け取ります。そして、selfがother以下である場合にTrueを、そうでない場合にFalseを返します。__le__を適切に実装することで、ユーザー定義のオブジェクトに対しても、min(), max(), sorted()のようなPythonの組み込み関数やソート機能が意図した通りに動作するようになり、コードの可読性と柔軟性が向上します。
構文(syntax)
1class MyComparable: 2 def __init__(self, value): 3 self.value = value 4 5 def __le__(self, other): 6 return self.value <= other.value 7 8obj1 = MyComparable(10) 9obj2 = MyComparable(20) 10result = obj1 <= obj2
引数(parameters)
self: Any, value: Any, /
- self: Any: 比較対象となるCallオブジェクト自身
- value: Any: 比較される値
戻り値(return)
bool
このメソッドは、2つのコールオブジェクトを比較し、左側のオブジェクトが右側のオブジェクト以下である場合にTrueを、それ以外の場合にFalseを返します。