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

CKTIS / Python

ValueError — une valeur d’argument inappropriée

ValueError indique qu’un argument a le type attendu, mais une valeur inacceptable. Découvrez en quoi il diffère de TypeError et comment le lever et l’intercepter.

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

Syntaxe

# Pattern 1: Raise ValueError
raise ValueError(message)

# Pattern 2 (separate snippet): Catch ValueError from an operation
try:
    operation()
except ValueError as exc:
    handle(exc)

ValueError est une exception intégrée levée lorsqu’une opération reçoit un argument du type attendu, mais dont la valeur est inappropriée, et qu’aucune exception plus précise, telle que IndexError, ne décrit la situation. Un type d’argument inapproprié est plutôt signalé par TypeError.

Dans votre propre code, utilisez raise ValueError(message) pour rejeter une valeur qui ne respecte pas les exigences d’une fonction. Dans l’exemple, le nombre 120 se situe en dehors de la plage de pourcentage autorisée, de 0 à 100 inclus. La fonction vérifie la plage ; elle ne réalise pas une validation complète des types.

Interceptez une erreur attendue avec except ValueError as exc. La variable exc fait référence à l’objet exception, dont vous pouvez afficher le message. Cette clause intercepte également les sous-classes de ValueError. Limitez le bloc try à l’opération dont vous souhaitez traiter l’échec, plutôt que de masquer des erreurs sans rapport au moyen d’une gestion générale des exceptions.

L’exemple lève explicitement l’exception et la traite ; il affiche donc le message fourni plutôt qu’une trace d’erreur non interceptée. La sortie attendue ne confirme pas qu’un test a été exécuté.

Exemples

def validate_percentage(value):
    if not 0 <= value <= 100:
        raise ValueError("percentage must be between 0 and 100")
    return value

try:
    validate_percentage(120)
except ValueError as exc:
    print(f"ValueError: {exc}")

Résultat

ValueError: percentage must be between 0 and 100

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