fsetpos

Задает индикатор позиции в потоке.

Синтаксис

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

Параметры

stream
Указатель на структуру FILE .

pos
Хранилище индикатора позиции.

Возвращаемое значение

В случае успеха fsetpos возвращает 0. При сбое функция возвращает ненулевое значение и задает errno одно из следующих констант манифеста (определено в ERRNO. H): EBADFэто означает, что файл недоступен или объект, stream указывающий на не является допустимой структурой файлов; или EINVALозначает недопустимое значение для stream или pos передано. Если недопустимый параметр передается, эти функции вызывают обработчик недопустимых параметров, как описано в разделе "Проверка параметров".

Дополнительные сведения о кодах возврата см. в разделе errno, _doserrno_sys_errlistи _sys_nerr.

Замечания

Функция fsetpos задает индикатор положения файла для stream значенияpos, полученного при предыдущем вызовеfgetpos.stream Функция очищает индикатор конца файла и отменяет любые последствия ungetc stream. После вызова fsetposследующая операция stream может быть входной или выходной.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Требования

Function Обязательный заголовок
fsetpos <stdio.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Пример

Пример см. в примере fgetpos.

См. также

Потоковый ввод-вывод
fgetpos