设置流位置指示器。
语法
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 的示例。