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);