fsetpos

设置流位置指示器。

语法

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

参数

stream
指向 FILE 结构的指针。

pos
位置指示器存储。

返回值

如果成功，则 fsetpos 返回 0。 失败时，该函数返回一个非零值，并将 errno 设置为下列任一清单常量（在 ERRNO.H 中定义）：EBADF 或 EINVAL。前一个意味着文件不可访问或 stream 指向的对象不是有效的文件结构；后一个意味着传递了 stream 或 pos 的一个无效值。 如果传入了无效参数，这些函数会调用无效参数处理程序，如参数验证中所述。

有关返回代码的详细信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

备注

fsetpos 函数将 stream 的文件位置指示器设置为 pos 的值，它是在先前针对 stream 执行对 fgetpos 的调用之前获取。 该函数会清除文件尾指示器，并撤消 ungetc 对 stream 的任何影响。 在调用 fsetpos 后，stream 上的下一个操作可能为输入或输出。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

要求

函数	必需的标头
fsetpos	<stdio.h>

有关兼容性的详细信息，请参阅 兼容性。

示例

请参阅 fgetpos 的示例。

另请参阅

流 I/O
fgetpos