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
UnboundLocalErrorUnboundLocalError 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.