raise

Lève une exception pour signaler une erreur ou une situation interdite.

Sur cette page

Exemple

#
Python
def set_level(level):
    if not isinstance(level, int):
        raise TypeError("Le niveau doit être un entier")
    if level < 1:
        raise ValueError(f"Le niveau doit être positif, reçu {level}")
    return level

for value in [5, 0, "3"]:
    try:
        print("Niveau défini à", set_level(value))
    except (TypeError, ValueError) as error:
        print("Erreur :", error)
Résultatrésultat enregistré, vous pouvez le vérifier
Niveau défini à 5
Erreur : Le niveau doit être positif, reçu 0
Erreur : Le niveau doit être un entier

Définition et utilisation

#

L’instruction raise lève une exception et interrompt l’action en cours. Le contrôle passe au bloc except le plus proche qui gère ce type d’exception. S’il n’y en a pas, le programme s’arrête avec un message d’erreur.

Levez une exception lorsqu’une fonction reçoit des données avec lesquelles elle ne peut raisonnablement pas travailler, par exemple un nombre de points négatif. Les types intégrés, comme ValueError ou TypeError, conviennent à la plupart des situations.

Vous créez vos propres exceptions en héritant de Exception. La notation raise NewError(...) from error conserve l’information sur la cause d’origine, ce qui facilite le débogage.

Syntaxe

#
Syntaxe
raise ExceptionType("message")

Plus d’exemples

#
Une exception personnalisée
Python
class OutOfFuelError(Exception):
    pass

def start_lesson(fuel):
    if fuel <= 0:
        raise OutOfFuelError("Plus de carburant pour la leçon suivante")
    return fuel - 1

try:
    start_lesson(0)
except OutOfFuelError as error:
    print(type(error).__name__, "-", error)
Résultatrésultat enregistré, vous pouvez le vérifier
OutOfFuelError - Plus de carburant pour la leçon suivante

Bonnes pratiques

#
  • Le message d’une exception doit dire ce qui s’est mal passé et quelle valeur en est la cause.
  • Nommez vos propres exceptions avec le suffixe Error, par exemple InvalidAnswerError.

Entrées associées

#

Pratiquer dans les leçons

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.