WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

UnboundLocalError – Lesen einer ungebundenen lokalen Variablen

UnboundLocalError tritt auf, wenn eine Funktion eine lokale Variable liest, der zu diesem Zeitpunkt kein Wert zugewiesen ist. Der Fehler ist eine Unterklasse von NameError; eine häufige Ursache ist eine Zuweisung, die eine Variable aus einem äußeren Gültigkeitsbereich überschattet.

Version: Python 3.14; repository image, production runtime not attested

Syntax

UnboundLocalError

UnboundLocalError bezeichnet den Versuch, eine lokale Variable einer Funktion zu lesen, der zu diesem Zeitpunkt kein Wert zugewiesen ist. Der Fehler ist eine Unterklasse von NameError: Wird ein Name nicht gefunden, entsteht ein NameError; im speziellen Fall einer ungebundenen lokalen Variable entsteht UnboundLocalError.

Eine Zuweisung an einen Namen innerhalb einer Funktion macht diesen im gesamten Funktionskörper lokal, sofern keine Deklaration mit global oder nonlocal gilt. Das gilt auch für eine Zuweisung in einem Zweig, der nie ausgeführt wird. Im Beispiel muss count += 1 zuerst den lokalen Wert von count lesen; der modulweite Wert count = 10 wird nicht verwendet. Der Fehler unterbricht den Aufruf, und der modulweite Wert bleibt 10.

Beheben Sie die Ursache: Stellen Sie sicher, dass vor jedem möglichen Lesen ein Wert zugewiesen wird, oder übergeben Sie den Wert als Argument und geben Sie das Ergebnis zurück. Wenn Sie einen Namen auf Modulebene neu binden möchten, verwenden Sie global; für eine bestehende Bindung in der nächstgelegenen umschließenden Funktion verwenden Sie nonlocal. Setzen Sie die Deklaration vor die Verwendung des Namens. Das Abfangen des Fehlers im Beispiel dient der Veranschaulichung und behebt den Gültigkeitsbereichsfehler nicht.

Beispiele

count = 10


def increment():
    count += 1
    return count


try:
    increment()
except UnboundLocalError as error:
    print(type(error).__name__)

print(count)

Ergebnis

UnboundLocalError
10

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen