Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

ValueError — un valore dell’argomento non appropriato

ValueError indica che un argomento ha il tipo corretto, ma un valore non accettabile. Scopri in cosa differisce da TypeError e come sollevarlo e intercettarlo.

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

Sintassi

# 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 è un’eccezione integrata che viene sollevata quando un’operazione riceve un argomento del tipo corretto ma con un valore non appropriato, e nessuna eccezione più specifica, come IndexError, descrive la situazione. Un tipo di argomento non appropriato viene invece segnalato da TypeError.

Nel tuo codice, usa raise ValueError(message) per rifiutare un valore che non rispetta i requisiti di una funzione. Nell’esempio, il numero 120 è fuori dall’intervallo percentuale consentito, da 0 a 100 inclusi. La funzione controlla l’intervallo; non esegue una convalida completa dei tipi.

Intercetta un errore previsto con except ValueError as exc. La variabile exc fa riferimento all’oggetto eccezione, di cui puoi stampare il messaggio. Questa clausola intercetta anche le sottoclassi di ValueError. Limita il blocco try all’operazione di cui vuoi gestire l’errore, invece di nascondere errori non correlati con una gestione generica delle eccezioni.

L’esempio solleva e gestisce esplicitamente l’eccezione, quindi stampa il messaggio fornito invece di un traceback non gestito. L’output previsto non conferma che sia stato eseguito un test.

Esempi

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}")

Risultato

ValueError: percentage must be between 0 and 100

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti