CKTIS / Python
ValueError — неподходяща стойност на аргумент
ValueError означава, че аргументът е от правилния тип, но има неприемлива стойност. Научете по какво се различава от TypeError и как да повдигате и прихващате това изключение.
Версия: Python 3.14; repository image, production runtime not attested
Синтаксис
# 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 е вградено изключение, което се повдига, когато операция получи аргумент от правилния тип, но с неподходяща стойност, и ситуацията не се описва от по-конкретно изключение, например IndexError. Неподходящият тип на аргумента се обозначава с TypeError.
В собствения си код използвайте raise ValueError(message), за да отхвърлите стойност, която не отговаря на изискванията на функцията. В примера числото 120 е извън допустимия процентен диапазон от 0 до 100 включително. Функцията проверява диапазона; това не е цялостна проверка на типовете.
Прихванете очаквана грешка с except ValueError as exc. Променливата exc сочи към обекта на изключението, чието съобщение можете да отпечатате. Тази клауза прихваща и подкласове на ValueError. Ограничете блока try до операцията, чиято грешка искате да обработите, вместо с широко прихващане на изключения да скривате несвързани грешки.
Примерът изрично повдига и обработва изключението, затова отпечатва предоставеното съобщение вместо необработен traceback. Очакваният изход не потвърждава, че е изпълнен тест.
Примери
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}")Резултат
ValueError: percentage must be between 0 and 100
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.