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

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

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

作成日: 更新日:

基本的な使い方

__class_getitem__メソッドは、Pythonの組み込みsetクラスをジェネリック型として扱えるようにするメソッドです。これは主に型ヒント(タイプアノテーション)の文脈で使用され、プログラムの可読性と堅牢性を向上させる役割を担います。

具体的には、Python 3.9以降で導入されたこのメソッドにより、set[int]やset[str]のように角括弧([])を用いてセットが保持する要素の型を明示的に指定できるようになりました。例えば、「整数のセット」を型ヒントとして表現したい場合、以前はfrom typing import SetとしてSet[int]と記述する必要がありましたが、このメソッドのおかげで、より直感的にset[int]と書けるようになりました。これは、list[str]やdict[str, int]といった他の組み込みコレクション型でも同様に利用できます。

set[int]のように記述された場合、この__class_getitem__メソッドが呼び出されます。しかし、実行時に実際に返されるのは、あくまで元のsetクラスそのものです。このメソッドは、実行時のsetオブジェクトの振る舞いを変更するものではありません。その代わり、静的型チェッカー(プログラムを実行する前に型の誤りなどを検出するツール)に対して、「このセットは整数型のみを格納することを意図している」という情報を提供します。

この機能は、コードを書く際に開発者が意図する型を明確にし、予期せぬ型エラーを事前に検出しやすくすることで、より高品質なソフトウェア開発を支援することを目的としています。

構文(syntax)

1set[int]

引数(parameters)

cls: type[set], item: Any

  • cls: type[set]: このメソッドを呼び出すクラス自身を表します(通常は set クラス)。
  • item: Any: セットの要素の型を指定します。

戻り値(return)

types.GenericAlias

class_getitem メソッドは、型ヒントでジェネリック型(例: list[int], dict[str, float])を使用する際に、その型を表す types.GenericAlias オブジェクトを返します。

関連コンテンツ