fseek(3)

НАИМЕНОВАНИЕ
fgetpos, fseek, fsetpos, ftell, rewind - меняют положение в потоке

БИБЛИОТЕКА
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> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков (<debian-l10n-russian@lists.debian.org>).