Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

UnboundLocalError — lecture d’une variable locale non liée

UnboundLocalError se produit lorsqu’une fonction lit une variable locale à laquelle aucune valeur n’est affectée à ce moment-là. C’est une sous-classe de NameError ; une cause fréquente est une affectation qui masque une variable d’une portée extérieure.

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

Syntaxe

UnboundLocalError

UnboundLocalError désigne la tentative de lire une variable locale à une fonction qui n’est liée à aucune valeur à ce moment-là. C’est une sous-classe de NameError : un nom introuvable provoque NameError, tandis que ce cas précis de variable locale non liée provoque UnboundLocalError.

L’affectation d’un nom dans une fonction le rend local dans tout le corps de cette fonction, sauf si une déclaration global ou nonlocal s’applique. Cela inclut une affectation dans une branche qui ne s’exécute jamais. Dans l’exemple, count += 1 doit d’abord lire la variable locale count ; il n’utilise pas le count = 10 défini au niveau du module. L’exception interrompt l’appel, et la valeur au niveau du module reste 10.

Corrigez la cause : assurez-vous qu’une valeur est affectée avant chaque lecture possible, ou transmettez la valeur en argument et renvoyez le résultat. Si vous voulez réaffecter un nom au niveau du module, utilisez global ; pour une liaison existante dans la fonction englobante la plus proche, utilisez nonlocal. Placez la déclaration avant l’utilisation du nom. Dans l’exemple, intercepter l’exception sert à la démonstration et ne corrige pas l’erreur de portée.

Exemples

count = 10


def increment():
    count += 1
    return count


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

print(count)

Résultat

UnboundLocalError
10

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources