Следующие функции используют экземпляр класса FileInput, созданный и сохраненный функцией input() . При попытке использования этих функций без предварительного вызова input() или после вызова функции close() генерируется исключение RuntimeError. Текущим всегда считается файл, из которого была прочитана последняя строка.

filename()

Возвращает имя файла, для которого была прочитана последняя строка. До того, как прочитана первая строка (в том числе непосредственно после вызова функции nextfile() ), возвращает None. Для стандартного потока ввода возвращает <stdin>.

lineno()

Возвращает суммарный номер последней прочитанной строки. До того, как прочитана первая строка (в том числе непосредственно после вызова функции nextfile() ), возвращает 0 .

filelineno()

Возвращает номер последней прочитанной строки в текущем файле. До того, как прочитана первая строка (в том числе непосредственно после вызова функции nextfile() ), возвращает 0 .

isfirstline()

Возвращает 1 , если последняя прочитанная строка является первой в текущем файле, иначе возвращает 0.

isstdin()

Возвращает 1 , если последняя строка была прочитана со стандартного потока ввода (sys.stdin), иначе возвращает 0.

nextfile()

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

close()

Вызывает метод close() экземпляра, сохраненного функцией input() .

Следующий класс реализует чтение из нескольких файлов и может быть использован для определения производных классов:

FileInput ([files [, inplace [, backup]]])

Создает и возвращает объект, обеспечивающий чтение строк из нескольких файлов. Аргумент files должен быть списком имен файлов или строкой с именем файла. По умолчанию используется sys.argv[1:] или стандартный поток ввода, если список аргументов командной строки пуст. Имя - является специальным, для него используется поток sys.stdin.

30.1. fileinput - перебор строк из нескольких входных потоков 411

Если задан и является истиной аргумент inplace, файл переименовывается в резервную копию с именем, полученным добавлением суффикса backup (по умолчанию используется .bak) к исходному имени файла, стандартный поток вывода перенаправляется в исходный файл, и перебираются строки резервной копии. Таким образом, одновременно с чтением строк Вы можете безопасно изменять исходный файл, выводя в него информацию, например, инструкцией print. Резервная копия удаляется при закрытии выходного файла. Такое редактирование файла ("in-place filtering") невозможно при чтении из стандартного потока ввода.

Текущая реализация не позволяет работать с файловой системой MS-DOS, которая налагает сильные ограничения на имена файлов.

Экземпляры класса FileInput ведут себя аналогично последовательностям, но предоставляют доступ к элементам в определенном порядке (этого достаточно для использования в инструкции for), а также имеют следующие методы:

filename()

Возвращает имя файла, для которого была прочитана последняя строка. До того, как прочитана первая строка (в том числе непосредственно после вызова метода nextfile() ), возвращает None. Для стандартного потока ввода возвращает <stdin>.

lineno()

Возвращает суммарный номер последней прочитанной строки. До того, как прочитана первая строка (в том числе непосредственно после вызова метода nextfile()), возвращает 0.

filelineno()

Возвращает номер последней прочитанной строки в текущем файле. До того, как прочитана первая строка (в том числе непосредственно после вызова метода nextfile() ), возвращает 0 .

isfirstline()

Возвращает 1 , если последняя прочитанная строка является первой в текущем файле, иначе возвращает 0 .

isstdin()

Возвращает 1 , если последняя строка была прочитана со стандартного потока ввода (sys.stdin), иначе возвращает 0.

nextfile()

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

close()

"Закрывает" объект.

readline()

Считывает и возвращает следующую строку. Этот метод увеличивает счетчик строк

30.2 ConfigParser - чтение конфигурационных файлов

Этот модуль определяет класс ConfigParser, реализующий чтение и обработку простых конфигурационных файлов, аналогичных по структуре .ini-файлам в Windows.

Конфигурационный файл состоит из разделов, начинающихся с заголовка вида [раздел] и содержащий строки вида имя: значение. Длинные значения могут быть записаны в несколько строк в стиле RFC 822. Также допускается использование строк вида имя= значение . Обратите внимание, что начальные символы пропуска из значения удаляются. Значения могут содержать строки формата, ссылающиеся на другие значения в этом же разделе или разделе default (раздел значений по умолчанию):

foodir: %(dir)s/whatever dir=frob

В приведенном примере последовательность %(dir)s будет заменена значением dir (здесь оно равно frob ). Дополнительные значения по умолчанию могут быть указаны при инициализации и извлечении. Строки, начинающиеся с символа # или ; считаются комментариями и игнорируются.

ConfigParser ([defaults])

Возвращает объект, отвечающий за чтение конфигурационного файла. Отображение defaults определяет значения по умолчанию: ключи в нем должны быть строками, определяющие имена, значения могут содержать последовательности вида %(имя)s. Заметим, что имя name всегда имеет значение, равное имени

раздела.

MAX INTERPOLATION DEPTH

Определяет максимальную глубину рекурсии при раскрытии специальных последовательностей в значениях опций. Эту переменную следует считать доступной только для чтения: ее изменение не окажет никакого влияния на работу модуля.

Модуль также определяет следующую иерархию исключений:

Error

Базовый класс для всех исключений, которые генерируются при ошибках, характерных для данного модуля.

NoSectionError

Указанный раздел (атрибут section экземпляра исключения) не найден.

на единицу, поэтому вызов obj .readline() внутри цикла for line in obj приведет к ошибке (исключение RuntimeError).