Python: Fehlercodes

Die Basisklasse für die integrierten Ausnahmen, die bei verschiedenen Rechenfehlern ausgelöst werden: OverflowError, ZeroDivisionError, FloatingPointError.

Wird ausgelöst, wenn eine Assert-Anweisung fehlschlägt.

Wird ausgelöst, wenn ein Attributverweis (siehe Attributverweise) oder eine Zuweisung fehlschlägt. (Wenn ein Objekt überhaupt keine Attributverweise oder Attributzuweisungen unterstützt, wird TypeError ausgelöst.) Die optionalen Nur-Schlüsselwortargumente name und obj legen die entsprechenden Attribute fest:

Beide Ausnahmetypen umschließen die Ausnahmen in der Sequenz excs. Der msg-Parameter muss eine Zeichenfolge sein. Der Unterschied zwischen den beiden Klassen besteht darin, dass BaseExceptionGroup BaseException erweitert und jede Ausnahme umschließen kann, während ExceptionGroup Exception erweitert und nur Unterklassen von Exception umschließen kann. Dieses Design ist so konzipiert, dass außer Exception eine ExceptionGroup abfängt, nicht jedoch BaseExceptionGroup. Der BaseExceptionGroup-Konstruktor gibt eine ExceptionGroup statt einer BaseExceptionGroup zurück, wenn alle enthaltenen Ausnahmen Ausnahmeinstanzen sind, sodass er verwendet werden kann, um die Auswahl automatisch vorzunehmen. Der ExceptionGroup-Konstruktor hingegen löst einen TypeError aus, wenn eine enthaltene Ausnahme keine Exception-Unterklasse ist. Ausnahmegruppen sind hinsichtlich des Typs ihrer enthaltenen Ausnahmen generisch. Beachten Sie, dass BaseExceptionGroup __new__() definiert. Daher müssen Unterklassen, die eine andere Konstruktorsignatur benötigen, diese überschreiben und nicht __init__(). Im Folgenden wird beispielsweise eine Unterklasse einer Ausnahmegruppe definiert, die einen Exit_code akzeptiert und daraus die Nachricht der Gruppe erstellt. Wie ExceptionGroup kann jede Unterklasse von BaseExceptionGroup, die auch eine Unterklasse von Exception ist, nur Instanzen von Exception umschließen.

Wird ausgelöst, wenn ein Vorgang ein Objekt (z. B. einen Socket) blockieren würde, das für einen nicht blockierenden Vorgang festgelegt ist. Entspricht errno EAGAIN, EALREADY, EWOULDBLOCK und EINPROGRESS. Zusätzlich zu denen von OSError kann BlockingIOError ein weiteres Attribut haben:

Eine Unterklasse von ConnectionError, die ausgelöst wird, wenn versucht wird, auf eine Pipe zu schreiben, während das andere Ende geschlossen ist, oder wenn versucht wird, auf einen Socket zu schreiben, der zum Schreiben heruntergefahren wurde. Entspricht errno EPIPE und ESHUTDOWN.

Wird ausgelöst, wenn ein pufferbezogener Vorgang nicht ausgeführt werden kann.

Basisklasse für Warnungen im Zusammenhang mit Bytes und Bytearray.

Wird ausgelöst, wenn ein Vorgang für einen untergeordneten Prozess fehlgeschlagen ist. Entspricht der Fehlernummer ECHILD.

Eine Unterklasse von ConnectionError, die ausgelöst wird, wenn ein Verbindungsversuch vom Peer abgebrochen wird. Entspricht der Fehlernummer ECONNABORTED.

Eine Basisklasse für verbindungsbezogene Probleme. Unterklassen sind BrokenPipeError, ConnectionAbortedError, ConnectionRefusedError und ConnectionResetError.

Eine Unterklasse von ConnectionError, die ausgelöst wird, wenn ein Verbindungsversuch vom Peer abgelehnt wird. Entspricht der Fehlernummer ECONNREFUSED.

Eine Unterklasse von ConnectionError, die ausgelöst wird, wenn eine Verbindung vom Peer zurückgesetzt wird. Entspricht der Fehlernummer ECONNRESET.

Basisklasse für Warnungen zu veralteten Funktionen, wenn diese Warnungen für andere Python-Entwickler bestimmt sind. Wird von den Standardwarnfiltern ignoriert, außer im __main__-Modul (PEP 565). Beim Aktivieren des Python-Entwicklungsmodus wird diese Warnung angezeigt. Die Abwertungsrichtlinie ist in PEP 387 beschrieben.

Wird ausgelöst, wenn die Funktion input() auf eine End-of-File-Bedingung (EOF) stößt, ohne Daten zu lesen. (Hinweis: Die Methoden io.TextIOBase.read() und io.IOBase.readline() geben eine leere Zeichenfolge zurück, wenn sie auf EOF treffen.)

Basisklasse für Warnungen im Zusammenhang mit Codierungen. Weitere Informationen finden Sie unter Opt-in-EncodingWarning.

Beide Ausnahmetypen umschließen die Ausnahmen in der Sequenz excs. Der msg-Parameter muss eine Zeichenfolge sein. Der Unterschied zwischen den beiden Klassen besteht darin, dass BaseExceptionGroup BaseException erweitert und jede Ausnahme umschließen kann, während ExceptionGroup Exception erweitert und nur Unterklassen von Exception umschließen kann. Dieses Design ist so konzipiert, dass außer Exception eine ExceptionGroup abfängt, nicht jedoch BaseExceptionGroup. Der BaseExceptionGroup-Konstruktor gibt eine ExceptionGroup statt einer BaseExceptionGroup zurück, wenn alle enthaltenen Ausnahmen Ausnahmeinstanzen sind, sodass er verwendet werden kann, um die Auswahl automatisch vorzunehmen. Der ExceptionGroup-Konstruktor hingegen löst einen TypeError aus, wenn eine enthaltene Ausnahme keine Exception-Unterklasse ist. Ausnahmegruppen sind hinsichtlich des Typs ihrer enthaltenen Ausnahmen generisch. Beachten Sie, dass BaseExceptionGroup __new__() definiert. Daher müssen Unterklassen, die eine andere Konstruktorsignatur benötigen, diese überschreiben und nicht __init__(). Im Folgenden wird beispielsweise eine Unterklasse einer Ausnahmegruppe definiert, die einen Exit_code akzeptiert und daraus die Nachricht der Gruppe erstellt. Wie ExceptionGroup kann jede Unterklasse von BaseExceptionGroup, die auch eine Unterklasse von Exception ist, nur Instanzen von Exception umschließen.

Wird ausgelöst, wenn versucht wird, eine bereits vorhandene Datei oder ein Verzeichnis zu erstellen. Entspricht Fehlernummer EEXIST.

Wird ausgelöst, wenn eine Datei oder ein Verzeichnis angefordert wird, aber nicht vorhanden ist. Entspricht Fehlernummer ENOENT.

Derzeit nicht verwendet.

Basisklasse für Warnungen zu veralteten Funktionen, wenn diese Warnungen für Endbenutzer von Anwendungen gedacht sind, die in Python geschrieben sind.

Eine Unterklasse von ImportError, die ausgelöst wird, wenn ein verzögerter Import fehlschlägt, weil er (direkt oder indirekt) versucht, sich selbst zu importieren.

Wird ausgelöst, wenn die Importanweisung beim Laden eines Moduls Probleme hat. Wird auch ausgelöst, wenn die „Von-Liste“ im from ...-Import einen Namen hat, der nicht gefunden werden kann. Die optionalen Nur-Schlüsselwortargumente Name und Pfad legen die entsprechenden Attribute fest:

Basisklasse für Warnungen vor möglichen Fehlern beim Modulimport. Wird von den Standardwarnfiltern ignoriert. Beim Aktivieren des Python-Entwicklungsmodus wird diese Warnung angezeigt.

Basisklasse für Syntaxfehler im Zusammenhang mit falscher Einrückung. Dies ist eine Unterklasse von SyntaxError.

Wird ausgelöst, wenn ein Sequenzindex außerhalb des gültigen Bereichs liegt. (Slice-Indizes werden stillschweigend gekürzt, um in den zulässigen Bereich zu fallen. Wenn ein Index keine Ganzzahl ist, wird TypeError ausgelöst.)

Wird ausgelöst, wenn ein Systemaufruf durch ein eingehendes Signal unterbrochen wird. Entspricht Fehlernummer EINTR.

Wird ausgelöst, wenn ein Dateivorgang (z. B. os.remove()) für ein Verzeichnis angefordert wird. Entspricht der Fehlernummer EISDIR.

Wird ausgelöst, wenn ein Zuordnungsschlüssel (Wörterbuchschlüssel) nicht im Satz vorhandener Schlüssel gefunden wird.

Die Basisklasse für die Ausnahmen, die ausgelöst werden, wenn ein für eine Zuordnung oder Sequenz verwendeter Schlüssel oder Index ungültig ist: IndexError, KeyError. Dies kann direkt durch codecs.lookup() ausgelöst werden.

Wird ausgelöst, wenn für einen Vorgang nicht mehr genügend Arbeitsspeicher vorhanden ist, die Situation aber dennoch gerettet werden kann (durch Löschen einiger Objekte). Der zugehörige Wert ist eine Zeichenfolge, die angibt, welche Art von (internem) Vorgang nicht über genügend Speicher verfügt. Beachten Sie, dass der Interpreter aufgrund der zugrunde liegenden Speicherverwaltungsarchitektur (malloc()-Funktion von C) möglicherweise nicht immer in der Lage ist, diese Situation vollständig zu beheben. Es wird dennoch eine Ausnahme ausgelöst, sodass ein Stack-Traceback gedruckt werden kann, falls ein außer Kontrolle geratenes Programm die Ursache war.

Eine Unterklasse von ImportError, die durch Import ausgelöst wird, wenn ein Modul nicht gefunden werden konnte. Es wird auch ausgelöst, wenn None in sys.modules gefunden wird.

Wird ausgelöst, wenn kein lokaler oder globaler Name gefunden wird. Dies gilt nur für unqualifizierte Namen. Der zugehörige Wert ist eine Fehlermeldung, die den Namen enthält, der nicht gefunden werden konnte. Das optionale Nur-Schlüsselwort-Argument „Name“ legt das Attribut fest:

Wird ausgelöst, wenn eine Verzeichnisoperation (z. B. os.listdir()) für etwas angefordert wird, das kein Verzeichnis ist. Auf den meisten POSIX-Plattformen kann es auch ausgelöst werden, wenn eine Operation versucht, eine Nicht-Verzeichnisdatei zu öffnen oder zu durchlaufen, als wäre es ein Verzeichnis. Entspricht Fehlernummer ENOTDIR.

Diese Ausnahme wird von RuntimeError abgeleitet. In benutzerdefinierten Basisklassen sollten abstrakte Methoden diese Ausnahme auslösen, wenn sie erfordern, dass abgeleitete Klassen die Methode überschreiben, oder während die Klasse entwickelt wird, um anzuzeigen, dass die tatsächliche Implementierung noch hinzugefügt werden muss.

Diese Ausnahme wird ausgelöst, wenn eine Systemfunktion einen systembezogenen Fehler zurückgibt, einschließlich E/A-Fehlern wie „Datei nicht gefunden“ oder „Datenträger voll“ (nicht für ungültige Argumenttypen oder andere zufällige Fehler). Die zweite Form des Konstruktors legt die entsprechenden Attribute fest, wie unten beschrieben. Wenn nicht angegeben, sind die Attribute standardmäßig „None“. Wenn drei Argumente übergeben werden, enthält das args-Attribut aus Gründen der Abwärtskompatibilität nur ein 2-Tupel der ersten beiden Konstruktorargumente. Der Konstruktor gibt häufig tatsächlich eine Unterklasse von OSError zurück, wie unten in den Betriebssystemausnahmen beschrieben. Die jeweilige Unterklasse hängt vom endgültigen Fehlernummerwert ab. Dieses Verhalten tritt nur auf, wenn OSError direkt oder über einen Alias ​​erstellt wird, und wird bei der Unterklassenerstellung nicht vererbt.

Wird ausgelöst, wenn das Ergebnis einer arithmetischen Operation zu groß ist, um dargestellt zu werden. Dies kann bei Ganzzahlen nicht der Fall sein (die eher MemoryError auslösen als aufgeben würden). Aus historischen Gründen wird OverflowError jedoch manchmal für Ganzzahlen ausgelöst, die außerhalb eines erforderlichen Bereichs liegen. Aufgrund der fehlenden Standardisierung der Gleitkomma-Ausnahmebehandlung in C werden die meisten Gleitkomma-Operationen nicht überprüft.

Basisklasse für Warnungen zu Funktionen, die veraltet sind und voraussichtlich in Zukunft veraltet sein werden, derzeit aber nicht veraltet sind. Diese Klasse wird selten verwendet, da das Ausgeben einer Warnung über eine mögliche bevorstehende Abwertung ungewöhnlich ist und DeprecationWarning für bereits aktive Abwertungen bevorzugt wird. Wird von den Standardwarnfiltern ignoriert. Beim Aktivieren des Python-Entwicklungsmodus wird diese Warnung angezeigt. Die Abwertungsrichtlinie ist in PEP 387 beschrieben.

Wird ausgelöst, wenn versucht wird, einen Vorgang ohne die entsprechenden Zugriffsrechte auszuführen – beispielsweise Dateisystemberechtigungen. Entspricht der Fehlernummer EACCES, EPERM und ENOTCAPABLE.

Wird ausgelöst, wenn ein bestimmter Prozess nicht existiert. Entspricht der Fehlernummer ESRCH.