14.2.19 Позиционирование в файле ¶

Для установки и определения позиции указателя файла для заданного файла доступны три функции.

: pos = ftell (fid) ¶

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

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

: status = fseek (fid, offset) ¶

: status = fseek (fid, offset, origin) ¶

Устанавливает указатель файла в местоположение offset внутри файла fid.

Указатель позиционируется на offset символов от origin, который может быть одним из предопределённых значений SEEK_SET (начало), SEEK_CUR (текущая позиция), или SEEK_END (конец файла) или строками "bof", "cof", или "eof". Если origin опущен, предполагается SEEK_SET. offset может быть положительным, отрицательным или нулевым, но не все комбинации origin и offset могут быть реализованы.

fseek возвращает 0 при успехе и -1 при ошибке.

См. также: fskipl, frewind, ftell, fopen, SEEK_SET, SEEK_CUR, SEEK_END.

: fseek_origin = SEEK_SET () ¶

Возвращает числовое значение для передачи в fseek для позиционирования указателя файла относительно начала файла.

См. также: SEEK_CUR, SEEK_END, fseek.

: fseek_origin = SEEK_CUR () ¶

Возвращает числовое значение для передачи в fseek для позиционирования указателя файла относительно текущей позиции.

См. также: SEEK_SET, SEEK_END, fseek.

: fseek_origin = SEEK_END () ¶

Возвращает числовое значение для передачи в fseek для позиционирования указателя файла относительно конца файла.

См. также: SEEK_SET, SEEK_CUR, fseek.

: frewind (fid) ¶

: status = frewind (fid) ¶

Перемещает указатель файла в начало файла, указанного дескриптором файла fid.

Если запрашивается выходной status, то frewind возвращает 0 для успеха и -1 при возникновении ошибки.

Примечание для программистов: frewind эквивалентно fseek (fid, 0, SEEK_SET).

См. также: fseek, ftell, fopen.

В следующем примере текущая позиция файла сохраняется в переменной marker, указатель перемещается в начало файла, считываются четыре символа, а затем он возвращается в исходное положение.

marker = ftell (myfile);
frewind (myfile);
fourch = fgets (myfile, 4);
fseek (myfile, marker, SEEK_SET);