Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes