11. Операции над внешними файлами

Первые 7 параметров функции передаются из CVF и соответствуют списку параметров CreateFile. Их значения берутся из соответствующего оператора OPEN:

lpFileName - адрес СИ-строки, содержащей имя файла; dwDesiredAccess - желаемый доступ;

dwShareMode - вид доступа (монопольный или разделяемый); lpSecurityAttributes - в Фортране всегда null; передается для ссылки

на структуру security_attributes;

dwCreationDisposition - вид выполняемых с файлом действий; dwFlagsAndAttributes - атрибуты файла и его флаги;

hTemplateFile - всегда null; передается для дескриптора временного файла функции CreateFile.

Последний параметр - устройство, указанное в операторе OPEN.

11.5. Оператор CLOSE

Оператор отсоединяет файл от устройства В/В изакрывает это устройство.

Описание параметров u, err и iostat см. в разд. 11.1.

status - символьное выражение, вычисляемое с одним из следующих значений:

•'KEEP' или 'SAVE' - файл сохраняется;

•'DELETE' - файл удаляется;

•'PRINT' - файл подается на печать и сохраняется (только для последовательных файлов);

•'PRINT/DELETE' - файл подается на печать и удаляется (только для последовательных файлов);

•'SUBMIT' - расщепляет процесс для исполнения файла;

•'SUBMIT/DELETE' - расщепляет процесс для исполнения файла и удаляет его после завершения операций.

По умолчанию действует статус 'DELETE' для scratch-файлов и окон QuickWin. Для остальных файлов действует 'KEEP'.

Задание STATUS = 'KEEP' для временных файлов вызывает ошибку выполнения. Для других видов файлов по умолчанию принимается статус

'KEEP'.

Если к устройству не был подсоединен файл, то никакой ошибки не возникает.

Открытые файлы не обязательно закрывать оператором CLOSE. При нормальном завершении программы они закрываются автоматически в соответствии с заданными для них статусами. Закрытие устройства (файла) 0 автоматически пересоединяет это устройство к клавиатуре и экрану.

361

О. В. Бартеньев. Современный ФОРТРАН

Закрытие устройств 5 и 6 пересоединяет эти устройства соответственно к клавиатуре и экрану. Оператор CLOSE(*) вызовет ошибку компиляции.

Пример:

! Закрываем устройство 7 и удаляем с диска подсоединенный к нему файл close(7, status = 'delete')

11.6. Оператор READ

Оператор выполняет передачу данных из подсоединенного к устройству u файла в указанные в списке ввода переменные. В CVF в случае прямого файла READ изменяет ассоциируемую переменную файла, указанную в соответствующем операторе OPEN. Передача данных выполняется до тех пор, пока не выполнены все операции ввода либо не возникли ситуации "конец файла" или ошибки. В случае ввода под управлением списка ввод прекращается при обнаружении в поле ввода слеша (/).

При вводе из файла или с клавиатуры оператор имеет вид:

[, ERR = err] [, IOSTAT = iostat] [, REC = rec] [, SIZE = size]) [iolist]

При работе с клавиатурой оператор можно записать так: READ * | fmt [, iolist]

Если спецификатор UNIT= опущен, то параметр u должен быть первым параметром оператора. Если опущены спецификаторы FMT или NML, то параметры fmt или nml должны быть вторыми параметрами оператора. В противном случае параметры могут появляться в произвольном порядке. u - устройство В/В (разд. 10.2 и 10.3). Устройство может быть задано

звездочкой (*). В таком случае ввод будет выполняться с клавиатуры. Если устройство не было подсоединено к файлу, то при чтении будут

выполнены действия, задаваемые оператором:

где form вычисляется со значениями 'FORMATTED' (при форматном вводе) и 'UNFORMATTED' (при неформатном). Если имя файла включено в запускающую программу командную строку, то это имя будет использовано для имени файла. В противном случае программа попросит ввести имя файла с клавиатуры.

fmt - спецификатор формата, которым может быть либо метка оператора FORMAT, либо символьное выражение, содержащее заключенный в круглые скобки список дескрипторов преобразований. При управляемом списком вводе в качестве fmt используется звездочка (*). Управляемый списком ввод возможен только из последовательных текстовых файлов. При неформатном или двоичном вводе параметр fmt должен быть опущен.

362

11. Операции над внешними файлами

nml - спецификатор именованного списка. При вводе именованного списка iolist должен быть опущен. Управляемый именованным списком ввод может быть выполнен только из текстовых файлов, открытых для последовательного доступа.

advance - символьное выражение, позволяющее задать продвигающийся или непродвигающийся последовательный форматный ввод и вычисляемое со значениями 'YES' или 'NO'. Значение 'YES' задается по умолчанию и означает, что задан продвигающийся ввод, т. е. после выполнения каждого оператора ввода файл позиционируется вслед за записью, из которой выполнялась передача данных. При непродвигающемся В/В (ADVANCE = = 'NO') файл оставляется сразу за последним переданным символом.

end - метка исполняемого оператора того же блока видимости, где применен оператор READ. Если спецификатор END присутствует, то при достижении конца файла управление передается на исполняемый оператор, метка которого end. Внешний файл устанавливается за записью "конец файла". Если END отсутствует и не заданы спецификаторы ERR или IOSTAT, то чтение после записи "конец файла" приведет к ошибке выполнения.

eor - метка оператора того же блока видимости, в котором размещен оператор READ. Если спецификатор EOR= задан, то также должен быть задан и спецификатор ADVANCE='NO'. Если спецификатор EOR= задан, выполнение оператора ввода прекращается при достижении конца записи (если ранее не было иной ошибки). Если EOR= опущен, то при достижении конца записи возникает ошибка, которую можно обработать спецификатором IOSTAT.

err - метка исполняемого оператора. При возникновении ошибки В/В управление передается на оператор, имеющий метку err.

iostat - целочисленная переменная, возвращает 0 при отсутствии ошибок; возвращает -1, если возникла ситуация "конец файла"; в противном случае возвращает номер возникшей ошибки. Состояние ошибки возникает, например, если обнаружен конец записи при непродвигающемся вводе.

rec - целочисленное выражение, возвращающее положительное число, называемое номером записи. Спецификатор REC может быть задан только при работе с файлами прямого доступа (иначе возникнет ошибка В/В). Если REC задан, то до ввода данных файл позиционируется на начало записи

сномером rec, что обеспечивает передачу данных из этой записи. Первая запись файла имеет номер 1. В FPS по умолчанию значение rec равно номеру текущей записи файла. И если при вводе из прямого файла параметр отсутствует, то будет введена текущая запись файла. В CVF при работе

спрямыми файлами наличие спецификатора REC обязательно.

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

363

О. В. Бартеньев. Современный ФОРТРАН

PAD = 'YES' пробелы не засчитываются. Спецификатор SIZE= может быть задан только при задании спецификатора ADVANCE = 'NO'. Например:

integer i, isv real a(10)

open(1, file = 'a.txt') do i = 1, 5

read(1, '(f5.1)', advance = 'no', size = isv) a(i) end do

print *, isv ! 5 end

Файл a.txt:

1.0 2.0 3.0 4.0 5.0 6.0 7.0 8.0 9.0 10.0

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

Если при вводе возникает ошибка, то выполнение оператора прекращается, все элементы списка ввода становятся неопределенными, а положение файла непредсказуемым.

Оператор READ может нарушить выполнение некоторых графических текстовых процедур, например SETTEXTWINDOW, которая изменяет текущую позицию курсора. Чтобы этого избежать, можно в графическом режиме выполнять ввод с клавиатуры, используя функцию GETCHARQQ, и выводить результаты на экран посредством процедуры OUTTEXT.

11.7. Оператор ACCEPT

Выполняет ввод данных с клавиатуры.

fmt - спецификатор формата, задаваемый без спецификатора FMT. iolist - список ввода.

nml - спецификатор именованного списка.

Пример:

real x integer k

print *, 'Enter real x and integer k'

364