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