CKTIS / Python
ValueError: un valor de argumento inadecuado
ValueError indica que un argumento tiene el tipo correcto, pero un valor no aceptable. Aprende en qué se diferencia de TypeError y cómo generar y capturar esta excepción.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
# 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 es una excepción integrada que se genera cuando una operación recibe un argumento del tipo correcto, pero con un valor inadecuado, y ninguna excepción más específica, como IndexError, describe la situación. En cambio, TypeError indica que el tipo del argumento es inadecuado.
En tu propio código, usa raise ValueError(message) para rechazar un valor que incumpla los requisitos de una función. En el ejemplo, el número 120 está fuera del intervalo de porcentaje permitido, de 0 a 100, ambos incluidos. La función comprueba el intervalo; no realiza una validación completa de tipos.
Captura un error esperado con except ValueError as exc. La variable exc hace referencia al objeto de la excepción, cuyo mensaje puedes imprimir. Esta cláusula también captura las subclases de ValueError. Limita el bloque try a la operación cuyo fallo quieres gestionar, en lugar de ocultar errores no relacionados mediante una captura general de excepciones.
El ejemplo genera y gestiona explícitamente la excepción, por lo que imprime el mensaje proporcionado en vez de un traceback no gestionado. La salida esperada no confirma que se haya ejecutado una prueba.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.