CKTIS / Python
ValueError — um valor de argumento inadequado
ValueError indica que um argumento tem o tipo correto, mas um valor inaceitável. Saiba em que difere de TypeError e como lançar e capturar esta exceção.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
# 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 é uma exceção integrada lançada quando uma operação recebe um argumento do tipo correto, mas com um valor inadequado, e nenhuma exceção mais específica, como IndexError, descreve a situação. Um tipo de argumento inadequado é, por sua vez, assinalado por TypeError.
No seu próprio código, use raise ValueError(message) para rejeitar um valor que não cumpra os requisitos de uma função. No exemplo, o número 120 está fora do intervalo percentual permitido, de 0 a 100, inclusive. A função verifica o intervalo; não faz uma validação completa dos tipos.
Capture um erro esperado com except ValueError as exc. A variável exc refere-se ao objeto da exceção, cuja mensagem pode imprimir. Esta cláusula também captura subclasses de ValueError. Limite o bloco try à operação cujo erro pretende tratar, em vez de ocultar erros não relacionados com um tratamento geral de exceções.
O exemplo lança e trata explicitamente a exceção, pelo que imprime a mensagem fornecida em vez de um traceback não tratado. O resultado esperado não confirma que tenha sido executado um teste.
Exemplos
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}")Resultado
ValueError: percentage must be between 0 and 100
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.