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

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

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

作成日: 更新日:

基本的な使い方

IndexError.__new__メソッドは、IndexErrorというPythonの組み込み例外オブジェクトを新しく生成するメソッドです。

この__new__メソッドは、Pythonのクラスにおいて新しいインスタンス(オブジェクト)がメモリ上に作成される際に、最も最初に呼び出される特別なメソッドです。オブジェクトの「箱」や「骨格」を作る役割を担っており、実際にそのオブジェクトがどのようなものになるかの土台を構築します。通常、オブジェクトが生成された後にその属性を設定し、初期化を行う__init__メソッドとは異なり、__new__メソッドはオブジェクトそのものを生成し、そのインスタンスを返します。

IndexErrorは、リストやタプル、文字列などのシーケンス型データにおいて、存在しないインデックス番号(要素の順番を示す番号)を指定してデータにアクセスしようとした際に発生する、Pythonの標準的なエラータイプです。例えば、3つの要素を持つリストに対して4番目の要素にアクセスしようとすると、このエラーが発生します。

したがって、IndexError.__new__メソッドは、プログラムがこのようなインデックスの範囲外アクセスを検出した際に、そのエラー情報を格納するための新しいIndexErrorオブジェクトを準備します。このオブジェクトが生成されることによって、後続の処理でエラーメッセージなどが設定され、どのようなエラーが起きたのかを正確に伝えるための具体的なエラー情報が形成されます。ほとんどの場合、このメソッドは基底クラスの__new__の振る舞いを継承しており、IndexError特有の生成ロジックが追加されることは通常ありません。

構文(syntax)

1IndexError.__new__(IndexError)

引数(parameters)

cls: type, *args: object, **kwargs: object

  • cls: type: 新しく作成されるインスタンスのクラス
  • *args: object: 位置引数
  • **kwargs: object: キーワード引数

戻り値(return)

IndexError

このメソッドは、IndexError クラスの新しいインスタンスを生成して返します。

関連コンテンツ