Чтение:
read()

Категория

Файлы

Уровень

Базовый

Связанные темы

Строки, позиция в файле, память

Зачем это знать

Получать содержимое файла в переменную

§1read() без аргумента

Вызов без аргументов возвращает всё содержимое файла как одну строку.

with open("demo.txt", encoding="utf-8") as file:
    content = file.read()

print(repr(content))

'первая строка\nвторая строка\nтретья строка\n'

Результат — обычная строка со всеми свойствами из модуля 5: к ней применимы срезы, split(), find() и остальные методы.

§2Позиция в файле

У открытого файла есть позиция — место, откуда пойдёт следующее чтение. Сразу после открытия она равна нулю, а любое чтение её сдвигает.

with open("demo.txt", encoding="utf-8") as file:
    print(file.tell())
    file.read(5)
    print(file.tell())

0
10

Число 10 вместо ожидаемых 5 — не ошибка: tell() считает байты, а пять кириллических символов занимают в UTF-8 десять байт. Подробно об этом — глава 8.11.

§3Повторный вызов

Из механики позиции следует поведение, которое ставит в тупик каждого второго новичка.

with open("demo.txt", encoding="utf-8") as file:
    first = file.read()
    second = file.read()

print(len(first))
print(repr(second))

42
''

§4read(size)

С аргументом метод читает не больше указанного числа символов и сдвигает позицию ровно на столько.

with open("demo.txt", encoding="utf-8") as file:
    print(repr(file.read(5)))
    print(repr(file.read(5)))

'перва'
'я стр'

Границы слов метод не учитывает — он отсчитывает символы. Если до конца файла осталось меньше запрошенного, вернётся столько, сколько есть.

§5Чтение порциями

Отсюда стандартный приём для больших файлов: читать блоками в цикле, пока не вернётся пустая строка.

with open("demo.txt", encoding="utf-8") as file:
    while True:
        chunk = file.read(10)
        if not chunk:
            break
        print(repr(chunk))

'первая стр'
'ока\nвторая'
' строка\nтр'
'етья строк'
'а\n'

Проверка if not chunk опирается на истинность из главы 3.16: пустая строка ложна. Так файл любого размера обрабатывается при фиксированном расходе памяти.

§6Символы, а не байты

В текстовом режиме аргумент size задаётся в символах. Это важно для кириллицы, где символ занимает два байта.

Несовпадение единиц в одной строке таблицы — источник путаницы при работе с позицией, и глава 8.11 разбирает его отдельно.

§7Пустой файл и конец файла

Ни то ни другое ошибкой не считается — просто возвращается пустая строка.

with open("empty.txt", "w", encoding="utf-8"):
    pass

with open("empty.txt", encoding="utf-8") as file:
    print(repr(file.read()))

''

Пустая строка — универсальный признак «читать больше нечего». Именно на нём построен цикл из §5.

§8Переводы строк в результате

read() возвращает текст как есть, вместе с символами \n. Обычный print() их выведет как настоящие переносы, и структура станет незаметной.

with open("demo.txt", encoding="utf-8") as file:
    content = file.read()

print(content)
print(repr(content))

первая строка
вторая строка
третья строка

'первая строка\nвторая строка\nтретья строка\n'

Пустая строка после третьей — след завершающего \n. При отладке файлов repr() из главы 5.2 незаменим.

§9Разбить на строки

Если нужен список строк, прочитанное разбивают методом splitlines() из главы 5.10.

with open("demo.txt", encoding="utf-8") as file:
    lines = file.read().splitlines()

print(lines)

['первая строка', 'вторая строка', 'третья строка']

Именно splitlines(), а не split("\n"): последний оставил бы лишний пустой элемент из-за завершающего перевода. Есть и готовый метод readlines() — глава 8.10, — но он сохраняет символы \n.

§10Когда read() не подходит

Метод загружает файл в память целиком. Для файла в несколько гигабайт это означает несколько гигабайт оперативной памяти.

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

with open("demo.txt", encoding="utf-8") as file:
    for line in file:
        print(repr(line))

'первая строка\n'
'вторая строка\n'
'третья строка\n'

§11Двоичное чтение

В режиме "rb" метод возвращает bytes, а не строку.

with open("demo.txt", "rb") as file:
    print(file.read(4))

b'\xd0\xbf\xd0\xb5'

Двоичное чтение опасно для текста: если прочитать нечётное число байтов, символ разорвётся пополам, и декодировать такой кусок будет нечем. Для текстовых файлов берут текстовый режим.

§12Ошибки при чтении

Первые три наследуют от OSError из главы 8.3, четвёртая — от ValueError через UnicodeError. Значит, except OSError покроет проблемы доступа, но не проблемы кодировки — их ловят отдельно.

§13Частые ошибки

§14Проверьте себя

§15Шпаргалка

Итог главы

read() без аргумента возвращает весь файл одной строкой, с аргументом — не больше указанного числа символов. Всё поведение объясняется позицией: она сдвигается при чтении, поэтому повторный вызов возвращает пустую строку, а не содержимое заново. Конец файла — не ошибка, а пустая строка, и на этом строится чтение блоками. Для больших файлов вместо read() берут построчный перебор, который не загружает всё в память.