fseek(3)

ИМЯ
fgetpos, fseek, fsetpos, ftell, rewind - меняют положение в потоке

LIBRARY
Standard C library (libc, -lc)

СИНТАКСИС
#include <stdio.h>

int fseek(FILE *stream, long offset, int whence);
long ftell(FILE *stream);

void rewind(FILE *stream);

int fgetpos(FILE *restrict stream, fpos_t *restrict pos);
int fsetpos(FILE *stream, const fpos_t *pos);

ОПИСАНИЕ
Функция fseek() устанавливает положение файлового индикатора в потоке, на который указывает аргумент stream. Новое положение (в байтах) получается прибавлением offset байтов к положению, которое задаётся параметром whence. Если значение whence равно SEEK_SET, SEEK_CUR или SEEK_END, то смещение указывается относительно начала файла, текущего положения указателя или конца файла, соответственно. Успешный вызов функции fseek() очищает (clear) индикатор конца файла потока и отменяет влияние функции ungetc(3) на этот же поток.

Функция ftell() возвращает текущее значение файлового индикатора положения для потока, на который указывает stream.

Функция rewind() устанавливает файловый индикатор положения для потока, на который указывает stream, равным началу файла. Эта функция эквивалентна вызову:

    (void) fseek(stream, 0L, SEEK_SET)

хотя в этом случае также сбрасывается индикатор ошибок потока (смотрите clearerr(3)).

Функции fgetpos() и fsetpos() эквивалентны ftell() и fseek() (где значение whence равно SEEK_SET); они сохраняют или устанавливают текущее значение файлового смещения в объектах, определяемых pos. В некоторых не-UNIX системах объект fpos_t может быть сложным объектом, а данные функции могут быть единственным переносимым способом изменения положения в текстовом потоке.

If the stream refers to a regular file and the resulting stream offset is beyond the size of the file, subsequent writes will extend the file with a hole, up to the offset, before committing any data. See lseek(2) for details on file seeking semantics.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Функция rewind() не возвращает значений. При успешном выполнении функции fgetpos(), fseek(), fsetpos() возвращают 0, а ftell() возвращает значение текущего смещения. В противном случае возвращается -1, а в errno записывается соответствующий код ошибки.

ОШИБКИ

EINVAL
    Значение whence в fseek() не равно SEEK_SET, SEEK_ или SEEK_CUR. Или результирующее смещение файла получается отрицательным.

ESPIPE
    Связанный со stream файловый дескриптор не допускает перемоток (верно для каналов, FIFO или сокетов).

При ошибках функции fgetpos(), fseek(), fsetpos() и ftell() устанавливают значение errno равным значению, определённому в функциях fflush(3), fstat(2), lseek(2) и malloc(3).

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
fseek(), ftell(), rewind(), fgetpos(), fsetpos() | Безвредность в нитях | MT-Safe

СТАНДАРТЫ
C11, POSIX.1-2008.

ИСТОРИЯ
POSIX.1-2001, C89.

СМ. ТАКЖЕ
lseek(2), fseeko(3)

ПЕРЕВОД
Русский перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 (https://www.gnu.org/licenses/gpl-3.0.html) или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.