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

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

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

作成日: 更新日:

基本的な使い方

__subclasshook__メソッドは、Pythonの抽象基底クラス(ABC)において、特定のクラスがそのABCのサブクラスであるかどうかをカスタムで判定するために実行するメソッドです。このメソッドは、通常、issubclass()関数やisinstance()関数が呼び出された際に、対象のクラスがABCのregister()メソッドで明示的に登録されていない場合に、サブクラス判定の最終的なロジックとして利用されます。

このメソッドは、サブクラスであると見なす場合にはTrueを、サブクラスではないと見なす場合にはFalseを返します。もし、このメソッドで判定を完了せず、Pythonのデフォルトのサブクラス判定メカニズムに処理を委ねたい場合は、NotImplementedを返します。これにより、明示的な継承関係がないにもかかわらず、特定の属性やメソッドを持っているクラスを、ある抽象基底クラスの「仮想サブクラス」として扱えるようになります。例えば、オブジェクトが特定のインターフェースの要件を満たしているかを動的に確認する際に非常に有効です。このメソッドは、@classmethodデコレータとともに定義される必要があります。

構文(syntax)

1import abc
2
3class MyAbstractClass(abc.ABC):
4    @classmethod
5    def __subclasshook__(cls, subclass):
6        if hasattr(subclass, 'perform_action') and \
7           callable(subclass.perform_action):
8            return True
9        return NotImplemented

引数(parameters)

cls, subclass: type

  • cls: 呼び出し元のクラス
  • subclass: 検査対象のサブクラス

戻り値(return)

Union[bool, NotImplementedType]

このメソッドは、サブクラスのチェック結果を示すブール値(TrueまたはFalse)、あるいはチェックができないことを示すNotImplementedを返します。

関連コンテンツ