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

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

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

作成日: 更新日:

基本的な使い方

__new__メソッドはOSErrorクラスの新しいインスタンスを生成するメソッドです。OSErrorは、ファイルの入出力操作やネットワーク接続など、システム関連の操作中に発生する様々なエラーを表すための基底例外クラスです。この__new__メソッドは、OSErrorのインスタンスが作成される際に最初に呼び出され、新しい例外オブジェクトを生成する役割を担っています。

例えば、OSError("ファイルが見つかりません", 2)のようにOSErrorクラスを直接呼び出すと、内部でこの__new__メソッドが実行され、指定されたエラーメッセージやエラーコードなどの情報を持つOSErrorのインスタンスが作成されます。生成されたインスタンスは、後続の__init__メソッドによって初期化されます。

開発者がこの__new__メソッドを直接呼び出すことは稀で、通常はPythonインタープリタによって自動的に実行されます。このメソッドは、OSErrorの子クラスで例外オブジェクトの生成ロジックをカスタマイズしたい場合にオーバーライドされることがあります。システムに起因する問題が発生したことを適切に通知し、プログラムの安定性向上に貢献する重要な役割を担っています。

構文(syntax)

1class OSError:
2    def __new__(cls, *args, **kwargs):
3        pass

引数(parameters)

cls, *args, **kwargs

  • cls: OSError クラス自身
  • *args: OSError の生成時に渡される位置引数
  • **kwargs: OSError の生成時に渡されるキーワード引数

戻り値(return)

OSErrorインスタンス

OSErrorクラスの新しいインスタンスが返されます。これは、例外オブジェクトの生成時に内部的に使用されます。

関連コンテンツ