fsetpos
来自cppreference.com
在标头 <stdio.h> 定义 | ||
按照 pos 所指向的值，设置文件流 stream 的文件位置指示器和多字节分析状态（若存在）。
调用此函数，除了建立新的分析状态和位置，还会撤销 ungetc 的效果，且若设置了文件尾状态则清除之。
若读或写出现错误，则设置流的错误指示器（ferror）。
参数
| stream | - | 要修改的文件流 |
| pos | - | 指向 fpos_t 对象的指针，用作文件位置指示器的新值 |
返回值
成功时为 0 ，否则为非零值。
注意
在寻位到宽流的非结尾位置后，下个对任何输出函数的调用可能使剩下的文件内容未定义，例如通过输出不同长度的多字节序列。
示例
fsetpos 带错误检查
运行此代码
#include <stdio.h> #include <stdlib.h> int main(void) { // 准备一个浮点值的数组。 #define SIZE 5 double A[SIZE] = {1.0, 2.0, 3.0, 4.0, 5.0}; // 写数组到文件。 FILE * fp = fopen("test.bin", "wb"); fwrite(A,sizeof(double),SIZE,fp); fclose (fp); // 读取浮点值到数组B。 double B[SIZE]; fp = fopen("test.bin","rb"); fpos_t pos; if (fgetpos(fp,&pos)) // 当前位置：文件起始 { perror("fgetpos()"); fprintf(stderr,"fgetpos() 失败。文件 %s 行 # %d\n", __FILE__,__LINE__-3); exit(EXIT_FAILURE); } int ret_code = fread(B,sizeof(double),1,fp); // 读取一个浮点值 // 当前位置：在读一个浮点值后 printf("%.1f; 读取计数 = %d\n", B[0], ret_code); // 打印一个浮点值和 ret_code if (fsetpos(fp,&pos)) // 重设当前位置为文件起始 { if (ferror(fp)) { perror("fsetpos()"); fprintf(stderr,"fsetpos() 失败。文件 %s 行 # %d\n", __FILE__,__LINE__-5); exit(EXIT_FAILURE); } } ret_code = fread(B,sizeof(double),1,fp); // 重读首个浮点值 printf("%.1f; 读取计数 = %d\n", B[0], ret_code); // 打印一个浮点值和 ret_code fclose(fp); return EXIT_SUCCESS; }
可能的输出：
1.0; 读取计数 = 1 1.0; 读取计数 = 1
引用
- C23 标准（ISO/IEC 9899:2024）：
- 7.21.9.3 The fsetpos function （第 TBD 页）
- C17 标准（ISO/IEC 9899:2018）：
- 7.21.9.3 The fsetpos function （第 TBD 页）
- C11 标准（ISO/IEC 9899:2011）：
- 7.21.9.3 The fsetpos function （第 337 页）
- C99 标准（ISO/IEC 9899:1999）：
- 7.19.9.3 The fsetpos function （第 303 页）
- C89/C90 标准（ISO/IEC 9899:1990）：
- 4.9.9.3 The fsetpos function
参阅
| 获取文件位置指示器 (函数) | |
| 返回当前的文件位置指示值 (函数) | |
| 将文件位置指示符移动到文件中的指定位置 (函数) | |
fsetpos 的 C++ 文档 | |