Поделиться через


fsetpos

Устанавливает индикатор позиции потока.

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

Параметры

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

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

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

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

Дополнительные сведения об этих и других кодах ошибок см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr.

Заметки

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

Требования

Функция

Обязательный заголовок

fsetpos

<stdio.h>

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

Пример

См. пример для fgetpos.

Эквивалент в .NET Framework

System::IO::FileStream::Position

См. также

Ссылки

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

fgetpos