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

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

pos = ftell (fid)

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

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

fseek (fid, offset)

fseek (fid, offset, origin)

status = fseek (…)

Устанавливает указатель файла в местоположение 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.

SEEK_SET ()

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

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

SEEK_CUR ()

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

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

SEEK_END ()

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

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

frewind (fid)

status = frewind (fid)

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

frewind возвращает 0 при успехе и -1 при возникновении ошибки. Это эквивалентно fseek (fid, 0, SEEK_SET).

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

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

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