Pythonのエラーコード

さまざまな算術エラーに対して発生する組み込み例外の基本クラス: OverflowError、ZeroDivisionError、FloatingPointError。

Assert ステートメントが失敗したときに発生します。

属性参照 (「属性参照」を参照) または割り当てが失敗したときに発生します。 (オブジェクトが属性参照または属性割り当てをまったくサポートしていない場合、TypeError が発生します。) オプションの name および obj キーワードのみの引数は、対応する属性を設定します。

これらの例外タイプは両方とも、例外をシーケンス excs でラップします。 msg パラメータは文字列である必要があります。 2 つのクラスの違いは、BaseExceptionGroup は BaseException を拡張し、あらゆる例外をラップできるのに対し、ExceptionGroup は Exception を拡張し、Exception のサブクラスのみをラップできることです。この設計では、Exception は ExceptionGroup をキャッチしますが、BaseExceptionGroup はキャッチしません。 BaseExceptionGroup コンストラクターは、含まれるすべての例外が Exception インスタンスである場合、BaseExceptionGroup ではなく ExceptionGroup を返すため、選択を自動化するために使用できます。一方、ExceptionGroup コンストラクターは、含まれている例外が Exception サブクラスではない場合、TypeError を生成します。 例外グループは、それに含まれる例外のタイプに対して汎用的です。 BaseExceptionGroup は __new__() を定義するため、別のコンストラクター シグネチャが必要なサブクラスは __init__() ではなくそれをオーバーライドする必要があることに注意してください。たとえば、次の例では、exit_code を受け入れ、そこからグループのメッセージを構築する例外グループ サブクラスを定義しています。 ExceptionGroup と同様、Exception のサブクラスでもある BaseExceptionGroup のサブクラスは、Exception のインスタンスのみをラップできます。

非ブロック操作に設定されたオブジェクト (ソケットなど) で操作がブロックされる場合に発生します。 errno EAGAIN、EALREADY、EWOULDBLOCK、および EINPROGRESS に対応します。 OSError の属性に加えて、BlockingIOError にはもう 1 つの属性を持つことができます。

ConnectionError のサブクラス。パイプのもう一方の端が閉じられているときにパイプに書き込もうとしたとき、または書き込みのためにシャットダウンされているソケットに書き込もうとしたときに発生します。エラー番号 EPIPE および ESHUTDOWN に対応します。

バッファ関連の操作を実行できない場合に発生します。

バイトおよびバイト配列に関連する警告の基本クラス。

子プロセスの操作が失敗したときに発生します。エラー番号 ECHILD に対応します。

ConnectionError のサブクラス。接続試行がピアによって中止されたときに発生します。エラー番号 ECONNABORTED に対応します。

接続関連の問題の基本クラス。 サブクラスは、BrokenPipeError、ConnectionAbortedError、ConnectionRefusedError、および ConnectionResetError です。

ConnectionError のサブクラス。接続試行がピアによって拒否されたときに発生します。エラー番号 ECONNREFused に対応します。

ConnectionError のサブクラス。ピアによって接続がリセットされたときに発生します。エラー番号 ECONNRESET に対応します。

非推奨の機能に関する警告が他の Python 開発者向けである場合の警告の基本クラス。 __main__ モジュール (PEP 565) を除き、デフォルトの警告フィルターでは無視されます。 Python 開発モードを有効にすると、この警告が表示されます。 非推奨ポリシーについては PEP 387 で説明されています。

input() 関数がデータをまったく読み込まずにファイルの終わり条件 (EOF) に達したときに発生します。 (注: io.TextIOBase.read() メソッドと io.IOBase.readline() メソッドは、EOF に達すると空の文字列を返します。)

エンコーディングに関連する警告の基本クラス。 詳細については、「オプトイン エンコーディング警告」を参照してください。

これらの例外タイプは両方とも、例外をシーケンス excs でラップします。 msg パラメータは文字列である必要があります。 2 つのクラスの違いは、BaseExceptionGroup は BaseException を拡張し、あらゆる例外をラップできるのに対し、ExceptionGroup は Exception を拡張し、Exception のサブクラスのみをラップできることです。この設計では、Exception は ExceptionGroup をキャッチしますが、BaseExceptionGroup はキャッチしません。 BaseExceptionGroup コンストラクターは、含まれるすべての例外が Exception インスタンスである場合、BaseExceptionGroup ではなく ExceptionGroup を返すため、選択を自動化するために使用できます。一方、ExceptionGroup コンストラクターは、含まれている例外が Exception サブクラスではない場合、TypeError を生成します。 例外グループは、それに含まれる例外のタイプに対して汎用的です。 BaseExceptionGroup は __new__() を定義するため、別のコンストラクター シグネチャが必要なサブクラスは __init__() ではなくそれをオーバーライドする必要があることに注意してください。たとえば、次の例では、exit_code を受け入れ、そこからグループのメッセージを構築する例外グループ サブクラスを定義しています。 ExceptionGroup と同様、Exception のサブクラスでもある BaseExceptionGroup のサブクラスは、Exception のインスタンスのみをラップできます。

すでに存在するファイルまたはディレクトリを作成しようとすると発生します。エラー番号 EEXIST に対応します。

ファイルまたはディレクトリが要求されたが存在しない場合に発生します。エラー番号 ENOENT に対応します。

現在は使用されていません。

非推奨の機能に関する警告が Python で作成されたアプリケーションのエンド ユーザーを対象とする場合の基本クラス。

ImportError のサブクラス。遅延インポートが (直接的または間接的に) 自身をインポートしようとして失敗した場合に発生します。

import ステートメントでモジュールをロードしようとして問題が発生した場合に発生します。 from ... import の「from リスト」の名前が見つからない場合にも発生します。 オプションの name および path キーワードのみの引数は、対応する属性を設定します。

モジュールのインポートで起こり得る間違いに関する警告の基本クラス。 デフォルトの警告フィルターでは無視されます。 Python 開発モードを有効にすると、この警告が表示されます。

不正なインデントに関連する構文エラーの基本クラス。これは SyntaxError のサブクラスです。

シーケンスの添字が範囲外の場合に発生します。 (スライス インデックスは、許可された範囲内に収まるように自動的に切り捨てられます。インデックスが整数でない場合は、TypeError が発生します。)

システム コールが着信信号によって中断されたときに発生します。エラー番号 EINTR に対応します。

ディレクトリ上でファイル操作 (os.remove() など) が要求されたときに発生します。エラー番号 EISDIR に対応します。

既存のキーのセット内にマッピング (辞書) キーが見つからない場合に発生します。

マッピングまたはシーケンスで使用されるキーまたはインデックスが無効な場合に発生する例外の基本クラス: IndexError、KeyError。これは codecs.lookup() によって直接発生させることができます。

操作でメモリが不足した場合に発生しますが、(一部のオブジェクトを削除することで) この状況はまだ救われる可能性があります。関連する値は、どのような種類の (内部) 操作でメモリ不足が発生したかを示す文字列です。基礎となるメモリ管理アーキテクチャ (C の malloc() 関数) のため、インタプリタはこの状況から常に完全に回復できるとは限らないことに注意してください。ただし、暴走プログラムが原因である場合に備えて、スタック トレースバックを出力できるように例外が発生します。

モジュールが見つからなかった場合にインポートによって発生する ImportError のサブクラス。 sys.modules で None が見つかった場合にも発生します。

ローカル名またはグローバル名が見つからない場合に発生します。これは、非修飾名にのみ適用されます。関連付けられた値は、見つからなかった名前を含むエラー メッセージです。 オプションの name キーワードのみの引数は、属性を設定します。

ディレクトリではないものに対してディレクトリ操作 (os.listdir() など) が要求されたときに発生します。ほとんどの POSIX プラットフォームでは、操作がディレクトリ以外のファイルをディレクトリであるかのように開いたり走査しようとした場合にも、このエラーが発生する可能性があります。エラー番号 ENOTDIR に対応します。

この例外は RuntimeError から派生します。ユーザー定義の基本クラスでは、抽象メソッドが派生クラスでメソッドをオーバーライドする必要がある場合、またはクラスの開発中に実際の実装をまだ追加する必要があることを示すために、この例外を発生させる必要があります。

この例外は、システム関数が「ファイルが見つかりません」や「ディスクがいっぱい」などの I/O エラーを含むシステム関連のエラーを返した場合に発生します (不正な引数の型やその他の付随的エラーの場合は除きます)。 コンストラクターの 2 番目の形式では、以下で説明する対応する属性を設定します。指定しない場合、属性はデフォルトで None になります。下位互換性のために、3 つの引数が渡された場合、args 属性には最初の 2 つのコンストラクター引数の 2 タプルのみが含まれます。 以下の OS 例外で説明するように、コンストラクターは実際には OSError のサブクラスを返すことがよくあります。特定のサブクラスは、最終的な errno 値によって異なります。この動作は、OSError を直接またはエイリアス経由で構築する場合にのみ発生し、サブクラス化する場合には継承されません。

算術演算の結果が大きすぎて表現できない場合に発生します。これは整数では発生しません (諦めるのではなく MemoryError が発生するでしょう)。ただし、歴史的な理由により、必要な範囲外の整数に対して OverflowError が発生することがあります。 C では浮動小数点例外処理が標準化されていないため、ほとんどの浮動小数点演算はチェックされません。

廃止され、将来廃止されることが予想されるが、現時点では廃止されていない機能に関する警告の基本クラス。 今後の非推奨の可能性について警告を発することは珍しいため、このクラスはめったに使用されず、すでにアクティブな非推奨には DeprecationWarning が推奨されます。 デフォルトの警告フィルターでは無視されます。 Python 開発モードを有効にすると、この警告が表示されます。 非推奨ポリシーについては PEP 387 で説明されています。

適切なアクセス権 (ファイルシステム権限など) を持たずに操作を実行しようとすると発生します。エラー番号 EACCES、EPERM、および ENOTCAPABLE に対応します。

指定されたプロセスが存在しない場合に発生します。エラー番号 ESRCH に対応します。