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

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

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

作成日: 更新日:

基本的な使い方

__class_getitem__メソッドは、Pythonの型ヒント機能において、tupleのような組み込みコンテナ型がジェネリック型として振る舞うことを可能にするために実行するメソッドです。このメソッドは、tuple[str, int]のようにクラス名の後に角括弧([])を用いて型引数を指定できるようにします。これにより、「最初の要素が文字列型、次の要素が整数型であるタプル」といった、特定の要素型を持つタプル型を静的に定義できるようになります。

この機能はPython 3.9で導入されたPEP 585によって実現されました。それまでは、同様の型ヒントを記述するためにtypingモジュールからTupleをインポートする必要がありましたが、__class_getitem__メソッドが提供されたことで、組み込みのtuple型を直接利用できるようになり、型ヒントの記述がより簡潔で直感的になりました。

__class_getitem__メソッドが呼び出されると、クラス自体が引数として渡された型情報(例: str, int)を処理し、その型引数に特化したジェネリック型オブジェクトを返します。この機能によって、開発者は関数や変数の宣言時に期待されるタプルの要素型を明確に指定でき、静的型チェッカーがコードの潜在的な型エラーを早期に検出するのに役立ちます。結果として、コードの可読性と保守性が向上し、特に大規模なシステム開発においてプログラムの信頼性確保に貢献します。

構文(syntax)

1my_tuple_type = tuple[str, int]

引数(parameters)

cls: type, item: Any

  • cls: type: このメソッドが属するクラス自体を表します。
  • item: Any: タプルから取得したい要素のインデックスやスライスを指定します。

戻り値(return)

types.GenericAlias

このメソッドは、型ヒントにおいてタプルの型を表すためのジェネリックエイリアスを返します。これにより、より厳密な型チェックが可能になります。

関連コンテンツ