> **Источник:** https://python-all.ru/3/library/fileinput.html > > «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor. --- # `fileinput` – итерация по строкам из нескольких входных потоков **Исходный код:** [Lib/fileinput.py](https://python-all.ru/src/3.14/Lib/fileinput.py) --- Этот модуль реализует вспомогательный класс и функции для быстрого создания цикла по стандартному вводу или списку файлов. Если нужно только прочитать или записать один файл, см. [`open()`](https://python-all.ru/3/library/functions.html#open). Типичное использование: ```python import fileinput for line in fileinput.input(encoding="utf-8"): process(line) ``` Функция перебирает строки всех файлов, указанных в `sys.argv[1:]`; если список пуст, по умолчанию используется `sys.stdin`. Если имя файла равно `'-'`, оно также заменяется на `sys.stdin`, а необязательные аргументы *mode* и *openhook* игнорируются. Чтобы задать альтернативный список имён файлов, передайте его первым аргументом в [`input()`](https://python-all.ru/3/library/fileinput.html#fileinput.input). Допускается также одно имя файла. Все файлы по умолчанию открываются в текстовом режиме, но это можно изменить, указав параметр *mode* в вызове [`input()`](https://python-all.ru/3/library/fileinput.html#fileinput.input) или [`FileInput`](https://python-all.ru/3/library/fileinput.html#fileinput.FileInput). Если при открытии или чтении файла происходит ошибка ввода-вывода, возбуждается [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError). Изменено в версии 3.3: [`IOError`](https://python-all.ru/3/library/exceptions.html#IOError) раньше возбуждалось; теперь оно является псевдонимом [`OSError`](https://python-all.ru/3/library/exceptions.html#OSError). Если `sys.stdin` используется более одного раза, второй и последующие вызовы не вернут ни одной строки, за исключением, возможно, интерактивного использования или если он был явно сброшен (например, с помощью `sys.stdin.seek(0)`). Пустые файлы открываются и сразу закрываются; их присутствие в списке имён файлов становится заметным, только когда последний открытый файл пуст. Строки возвращаются с сохранением всех символов новой строки; это означает, что последняя строка в файле может не иметь такого символа. Можно управлять открытием файлов, передав хук открытия через параметр *openhook* в [`fileinput.input()`](https://python-all.ru/3/library/fileinput.html#fileinput.input) или [`FileInput()`](https://python-all.ru/3/library/fileinput.html#fileinput.FileInput). Хук должен быть функцией, принимающей два аргумента: *filename* и *mode*, и возвращающей соответствующий образом открытый файлоподобный объект. Если указаны *encoding* и/или *errors*, они будут переданы хуку как дополнительные именованные аргументы. Этот модуль предоставляет [`hook_compressed()`](https://python-all.ru/3/library/fileinput.html#fileinput.hook_compressed) для поддержки сжатых файлов. Следующая функция является основным интерфейсом этого модуля: #### `fileinput.input(files=None, inplace=False, backup='', *, mode='r', openhook=None, encoding=None, errors=None)` Создаёт экземпляр класса [`FileInput`](https://python-all.ru/3/library/fileinput.html#fileinput.FileInput). Этот экземпляр будет использоваться как глобальное состояние для функций этого модуля, а также возвращается для использования во время итерации. Параметры этой функции будут переданы конструктору класса `FileInput`. Экземпляр [`FileInput`](https://python-all.ru/3/library/fileinput.html#fileinput.FileInput) можно использовать как контекстный менеджер в операторе [`with`](https://python-all.ru/3/reference/compound_stmts.html#with). В этом примере *input* закрывается после выхода из оператора `with`, даже если возникло исключение: ```python with fileinput.input(files=('spam.txt', 'eggs.txt'), encoding="utf-8") as f: for line in f: process(line) ``` Изменено в версии 3.2: Может использоваться как контекстный менеджер. Изменено в версии 3.8: Именованные параметры *mode* и *openhook* теперь являются только ключевыми (keyword-only). Изменено в версии 3.10: Добавлены параметры *encoding* и *errors*, которые являются только ключевыми. Следующие функции используют глобальное состояние, созданное [`fileinput.input()`](https://python-all.ru/3/library/fileinput.html#fileinput.input); если активное состояние отсутствует, возбуждается [`RuntimeError`](https://python-all.ru/3/library/exceptions.html#RuntimeError). #### `fileinput.filename()` Возвращает имя файла, который в данный момент читается. До чтения первой строки возвращает `None`. #### `fileinput.fileno()` Возвращает целочисленный «файловый дескриптор» текущего файла. Когда файл не открыт (до первой строки и между файлами), возвращает `-1`. #### `fileinput.lineno()` Возвращает накопленный номер строки для только что прочитанной строки. До чтения первой строки возвращает `0`. После чтения последней строки последнего файла возвращает номер этой строки. #### `fileinput.filelineno()` Возвращает номер строки в текущем файле. До чтения первой строки возвращает `0`. После чтения последней строки последнего файла возвращает номер этой строки внутри файла. #### `fileinput.isfirstline()` Возвращает `True`, если только что прочитанная строка является первой строкой своего файла, иначе возвращает `False`. #### `fileinput.isstdin()` Возвращает `True`, если последняя строка была прочитана из `sys.stdin`, иначе возвращает `False`. #### `fileinput.nextfile()` Закрывает текущий файл, чтобы следующая итерация начала чтение с первой строки следующего файла (если такой есть); строки, не прочитанные из файла, не учитываются в общем количестве строк. Имя файла не изменяется до тех пор, пока не будет прочитана первая строка следующего файла. До чтения первой строки эта функция не действует; её нельзя использовать для пропуска первого файла. После чтения последней строки последнего файла эта функция также не действует. #### `fileinput.close()` Закрывает последовательность. Класс, реализующий поведение последовательности, предоставляемое модулем, также доступен для создания подклассов: #### `class fileinput.FileInput(files=None, inplace=False, backup='', *, mode='r', openhook=None, encoding=None, errors=None)` Класс `FileInput` является реализацией; его методы [`filename()`](https://python-all.ru/3/library/fileinput.html#fileinput.filename), [`fileno()`](https://python-all.ru/3/library/fileinput.html#fileinput.fileno), [`lineno()`](https://python-all.ru/3/library/fileinput.html#fileinput.lineno), [`filelineno()`](https://python-all.ru/3/library/fileinput.html#fileinput.filelineno), [`isfirstline()`](https://python-all.ru/3/library/fileinput.html#fileinput.isfirstline), [`isstdin()`](https://python-all.ru/3/library/fileinput.html#fileinput.isstdin), [`nextfile()`](https://python-all.ru/3/library/fileinput.html#fileinput.nextfile) и [`close()`](https://python-all.ru/3/library/fileinput.html#fileinput.close) соответствуют функциям с теми же именами в модуле. Кроме того, он является [итерируемым](https://python-all.ru/3/glossary.html#term-iterable) и имеет метод [`readline()`](https://python-all.ru/3/library/io.html#io.TextIOBase.readline), который возвращает следующую входную строку. К последовательности следует обращаться строго последовательно; произвольный доступ и `readline()` несовместимы. С помощью *mode* можно указать, какой режим файла будет передан в [`open()`](https://python-all.ru/3/library/functions.html#open). Он должен быть одним из `'r'` и `'rb'`. Параметр *openhook*, если задан, должен быть функцией, принимающей два аргумента: *filename* и *mode*, и возвращающей соответствующим образом открытый файлоподобный объект. *inplace* и *openhook* нельзя использовать вместе. Можно указать *encoding* и *errors*, которые передаются в [`open()`](https://python-all.ru/3/library/functions.html#open) или *openhook*. Экземпляр `FileInput` можно использовать как контекстный менеджер в операторе [`with`](https://python-all.ru/3/reference/compound_stmts.html#with). В этом примере *input* закрывается после выхода из оператора `with`, даже если возникло исключение: ```python with FileInput(files=('spam.txt', 'eggs.txt')) as input: process(input) ``` Изменено в версии 3.2: Может использоваться как контекстный менеджер. Изменено в версии 3.8: Именованные параметры *mode* и *openhook* теперь передаются только как именованные (keyword-only). Изменено в версии 3.10: Добавлены именованные параметры *encoding* и *errors*. Изменено в версии 3.11: Режимы `'rU'` и `'U'`, а также метод `__getitem__()` были удалены. **Необязательная фильтрация на месте:** если именованный аргумент `inplace=True` передан в [`fileinput.input()`](https://python-all.ru/3/library/fileinput.html#fileinput.input) или в конструктор [`FileInput`](https://python-all.ru/3/library/fileinput.html#fileinput.FileInput), файл перемещается в резервную копию, а стандартный вывод направляется во входной файл (если файл с тем же именем, что и резервная копия, уже существует, он будет молча заменён). Это позволяет написать фильтр, который перезаписывает свой входной файл на месте. Если задан параметр *backup* (обычно как `backup='.'`), он указывает расширение для резервного файла, и резервный файл остаётся; по умолчанию расширение равно `'.bak'` и оно удаляется при закрытии выходного файла. Фильтрация на месте отключается, когда читается стандартный ввод. Следующие два хука открытия предоставляются этим модулем: #### `fileinput.hook_compressed(filename, mode, *, encoding=None, errors=None)` Прозрачно открывает файлы, сжатые gzip и bzip2 (распознаваемые по расширениям `'.gz'` и `'.bz2'`), с использованием модулей [`gzip`](https://python-all.ru/3/library/gzip.html#module-gzip) и [`bz2`](https://python-all.ru/3/library/bz2.html#module-bz2). Если расширение имени файла не `'.gz'` и не `'.bz2'`, файл открывается обычным образом (то есть с помощью [`open()`](https://python-all.ru/3/library/functions.html#open) без какого-либо распаковывания). Значения *encoding* и *errors* передаются в [`io.TextIOWrapper`](https://python-all.ru/3/library/io.html#io.TextIOWrapper) для сжатых файлов и в open для обычных файлов. Пример использования: `fi = fileinput.FileInput(openhook=fileinput.hook_compressed, encoding="utf-8")` Изменено в версии 3.10: Добавлены именованные параметры *encoding* и *errors*. #### `fileinput.hook_encoded(encoding, errors=None)` Возвращает хук, который открывает каждый файл с помощью [`open()`](https://python-all.ru/3/library/functions.html#open), используя заданные *encoding* и *errors* для чтения файла. Пример использования: `fi = fileinput.FileInput(openhook=fileinput.hook_encoded("utf-8", "surrogateescape"))` Изменено в версии 3.6: Добавлен необязательный параметр *errors*. Устарело с версии 3.10: Эта функция устарела, поскольку [`fileinput.input()`](https://python-all.ru/3/library/fileinput.html#fileinput.input) и [`FileInput`](https://python-all.ru/3/library/fileinput.html#fileinput.FileInput) теперь имеют параметры *encoding* и *errors*.