ValueError в Python: разбор строк в числа

Данные из файлов, форм и API приходят строками, и первым делом их превращают в числа: int('17'), float('3.14'). Разбор ломается на живом вводе регулярно — пользователь набрал словами, файл пришёл с пустой строкой. Третий урок курса уже ловил эту ошибку в ветке except ValueError; теперь разберёмся, когда именно она возникает и что говорит её сообщение.

Разбор строки, которая не число

age_text = 'восемнадцать'
age = int(age_text)

Ошибка ValueError означает, что тип операции подходящий, а значение в него не помещается. Сравните с TypeError из мира несоответствий: там операция вообще не применима к такому типу, а здесь int со строками работает — просто из этой конкретной строки число не извлекается. Формулировка invalid literal означает «неверный литерал»: запись числа не выдержана.

Перебираем грязный ввод

for text in ['17', 'восемнадцать', '']:
    try:
        print(repr(text), '->', int(text))
    except ValueError as e:
        print(repr(text), '->', type(e).__name__, '-', str(e))

'17' -> 17
'восемнадцать' -> ValueError - invalid literal for int() with base 10: 'восемнадцать'
'' -> ValueError - invalid literal for int() with base 10: ''

Функция repr печатает строку в кавычках — удобно видеть, что именно разбиралось, особенно пустую строку, которая на экране выглядит как ничего. Сообщение ValueError в каждой ветке называет виновника: и слово словами, и пустота дают одну и ту же ошибку с разным значением внутри. int() строг к содержимому: пробелы по краям он прощает, но дробную запись и лишние слова не примет.

for text in ['  42 ', '42.5', '4 2']:
    try:
        print(repr(text), '->', int(text))
    except ValueError as e:
        print(repr(text), '->', type(e).__name__, '-', str(e))

'  42 ' -> 42
'42.5' -> ValueError - invalid literal for int() with base 10: '42.5'
'4 2' -> ValueError - invalid literal for int() with base 10: '4 2'

Пробелы по краям int обрезает сам, а вот точка — уже не его дело: '42.5' для целого числа неверная запись, даже хотя выглядит числом. Пустая строка между цифрами ломает разбор так же, как слово. Кстати, int('42.5') не округляет: чтобы получить дробное число, нужен float.

for text in ['3.14', 'abc']:
    try:
        print(repr(text), '->', float(text))
    except ValueError as e:
        print(repr(text), '->', type(e).__name__, '-', str(e))

try:
    int(['1', '2'])
except TypeError as e:
    print('список ->', type(e).__name__, '-', str(e))

'3.14' -> 3.14
'abc' -> ValueError - could not convert string to float: 'abc'
список -> TypeError - int() argument must be a string, a bytes-like object or a real number, not 'list'

Граница между двумя ошибками видна в одном примере. Строка 'abc' — подходящий тип, неподходящее значение: ValueError. Список — неподходящий тип вовсе: TypeError с внятным перечислением того, что int принимает. Правило простое: ловить нужно ту ошибку, которая реально случится в вашем коде. Разбираете строки — ловите ValueError, а TypeError останется сигналом о баге.

Проверка заранее: isdigit

Второй способ жить с грязным вводом — спросить у строки, число ли она, до вызова int. У строк для этого есть метод isdigit:

candidates = ['123', '42.5', '-7', '', 'восемь']
for text in candidates:
    print(repr(text), 'isdigit:', text.isdigit())

'123' isdigit: True
'42.5' isdigit: False
'-7' isdigit: False
'' isdigit: False
'восемь' isdigit: False

Метод строг: только чистые цифры от края до края. Минус цифрой не считается, поэтому '-7' не проходит проверку — хотя int его отлично разбирает. Точка тоже не цифра. Из-за такой строгости isdigit подходит не для всех вводов: возраст со знаком минус, цену с копейками — всё это отсеется.

def safe_int(text, default=0):
    if text.isdigit():
        return int(text)
    return default

print(safe_int('42'))
print(safe_int('восемнадцать'))
print(safe_int('17', default=-1))

42
0
17

Классический каркас: проверка пускает к int только чистые цифры, всё остальное получает умолчание. Удобно, пока ввод заведомо положительные целые. Как только появляются минусы или дроби, проверка начинает отбраковывать годные значения — и тут try с except ValueError честнее: он решает по факту, а не по предположению. Какой стиль выбрать — вопрос из четырнадцатого урока об EAFP.

Разбор ввода — самая разносторонняя тренировка для try и except: строки приходят пустыми, словами, с пробелами и минусами, и каждая форма по-своему проверяется. А когда нужно зафиксировать правило для разработчика, а не для пользователя — пригодится assert из восемнадцатого урока.