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