14.2.18 Конец файла и ошибки

После открытия файла можно получить сведения о его состоянии. Например, функции feof определяют, достигнут ли конец файла. Это может быть очень полезно при чтении файла небольшими частями. В следующем примере показано, как считывать из файла по одной строке до достижения конца файла.

filename = "myfile.txt";
fid = fopen (filename, "r");
while (! feof (fid) )
  text_line = fgetl (fid);
endwhile
fclose (fid);

Обратите внимание, что в некоторых ситуациях эффективнее считать всё содержимое файла, а затем обработать его, чем читать построчно. Потенциальное преимущество такого подхода — устранение цикла из приведённого выше кода.

: status = feof (fid)

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

Обратите внимание, что feof возвращает 1 только в том случае, если конец файла уже достигнут, а не если следующая операция чтения приведёт к условию конца файла.

См. также: fread, frewind, fseek, fclear, fopen.

: msg = ferror (fid)

: [msg, err] = ferror (fid)

: […] = ferror (fid, "clear")

Запрашивает состояние ошибки потока, указанного дескриптором файла fid.

Если возникла ошибка, возвращает строку msg с описанием ошибки. В противном случае возвращает пустую строку "".

Второй входной аргумент "clear" является необязательным. Если он указан, состояние ошибки потока будет сброшено.

Необязательный второй выходной аргумент содержит числовое обозначение состояния ошибки. err равен 1, если обнаружена ошибка, и 0 в противном случае.

Обратите внимание, что ferror указывает, произошла ли ошибка ранее, а не приведёт ли следующая операция к возникновению ошибки.

См. также: fclear, fopen.

: fclear (fid)

Сбрасывает состояние потока для файла, указанного дескриптором файла fid.

См. также: ferror, fopen.

: freport ()

Выводит список открытых файлов и указывает, открыты ли они для чтения, записи или для обеих операций.

Например:

freport ()

     -|  number  mode  arch       name
     -|  ------  ----  ----       ----
     -|     0     r    ieee-le    stdin
     -|     1     w    ieee-le    stdout
     -|     2     w    ieee-le    stderr
     -|     3     r    ieee-le    myfile

См. также: fopen, fclose, is_valid_file_id.