База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници