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

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

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

作成日: 更新日:

基本的な使い方

__subclasshook__メソッドは、クラスが別のクラスのサブクラスであるかどうか、あるいはそのクラスのインスタンスであるかどうかをPythonが判断する際の挙動をカスタマイズするために実行されるメソッドです。このメソッドは、主に抽象基底クラス(ABC: Abstract Base Class)と呼ばれる特別なクラスで利用されます。ABCは、特定のメソッドやプロパティのセットを持つクラスを、明示的な継承関係がなくても「仮想的なサブクラス」として認識させる仕組みを提供します。

具体的には、issubclass(SubClass, BaseClass)という関数が呼び出され、SubClassがBaseClassのサブクラスであるかを判定する際に、BaseClassに__subclasshook__メソッドが定義されていると、通常の継承階層のチェックに先立ってこのメソッドが呼び出されます。このメソッドがTrueを返せば、明示的な継承がなくてもサブクラスであると判断され、Falseを返せばサブクラスではないと判断されます。もしNotImplementedを返した場合は、通常の継承チェックが引き続き行われます。

UnicodeWarningクラスは、Pythonでユニコード関連のエンコーディングやデコーディング処理において問題が発生した際に発行される警告を表現する、組み込みの警告クラスです。UnicodeWarning自体は抽象基底クラスではありませんが、Pythonの全てのクラスはobjectクラスから派生しており、型システムの内部でこの__subclasshook__メソッドが存在し得ます。ただし、UnicodeWarningクラスにおいてこのメソッドを直接オーバーライドして利用することは、一般的な用途ではありません。

構文(syntax)

1class UnicodeWarning(Warning):
2    @classmethod
3    def __subclasshook__(cls, subclass):
4        return NotImplemented

引数(parameters)

cls: type, subclass: type

  • cls: type: このメソッドが定義されているクラス自身
  • subclass: type: 検査対象のサブクラス

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ