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
.