C 参考手册
- C 语言
- C 关键词
- 预处理器
- C 标准库头文件
- 类型支持
- 程序支持工具
- 变参数函数
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 算法
- 数值
- 文件输入/输出
- gets, gets_s
- printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s
- fopen, fopen_s
- fputc, putc
- fputs
- getchar
- putchar
- FILE
- fpos_t
- stdin, stdout, stderr
- freopen, freopen_s
- fwide
- setbuf
- setvbuf
- fclose
- fflush
- fread
- fwrite
- fgetc, getc
- fgets
- puts
- ungetc
- fgetwc
- fgetws
- fputwc, putwc
- fputws
- getwchar
- putwchar
- ungetwc
- scanf, fscanf, sscanf, scanf_s, fscanf_s, sscanf_s
- wscanf, fwscanf, swscanf, wscanf_s, fwscanf_s, swscanf_s
- vscanf, vfscanf, vsscanf, vscanf_s, vfscanf_s, vsscanf_s
- vwscanf, vfwscanf, vswscanf, vwscanf_s, vfwscanf_s, vswscanf_s
- wprintf, fwprintf, swprintf, wprintf_s, fwprintf_s, swprintf_s, snwprintf_s
- vprintf, vfprintf, vsprintf, vsnprintf, vprintf_s, vfprintf_s, vsprintf_s, vsnprintf_s
- vwprintf, vfwprintf, vswprintf, vwprintf_s, vfwprintf_s, vswprintf_s, vsnwprintf_s
- ftell
- fgetpos
- fseek
- fsetpos
- rewind
- clearerr
- feof
- ferror
- perror
- remove
- rename
- tmpfile, tmpfile_s
- tmpnam, tmpnam_s
- 本地化支持
- 原子操作库
- 线程支持库
- 实验性 C 标准库
- 有用的资源
- 符号索引
- 注释
fgetpos
定义于头文件 <stdio.h>
|
||
(C99 前) | ||
(C99 起) | ||
获得文件流 stream
的文件位置指示器和当前分析状态(若存在),并将它们存储于 pos
所指向的对象。存储的值仅在作为 fsetpos 的输入的情况有意义。
参数
stream | - | 要检验的文件流 |
pos | - | 指向要存储文件位置指示器到的 fpos_t 对象的指针 |
返回值
成功时为 0 ,否则非零值。
示例
运行此代码
#include <stdio.h> #include <stdlib.h> #include <assert.h> int main(void) { // 准备保有 4 个 double 类型值的文件 enum {SIZE = 4}; FILE* fp = fopen("test.bin", "wb"); assert(fp); int rc = fwrite((double[SIZE]){1.1, 2.2, 3.3, 4.4}, sizeof(double), SIZE, fp); assert(rc == SIZE); fclose(fp); // 演示使用 fsetpos 返回到文件起始 fp = fopen("test.bin", "rb"); fpos_t pos; fgetpos(fp, &pos); // 存储文件起始于 pos double d; rc = fread(&d, sizeof d, 1, fp); // 读取首个 double assert(rc == 1); printf("First value in the file: %.1f\n", d); fsetpos(fp,&pos); // 移动文件位置回文件起始 rc = fread(&d, sizeof d, 1, fp); // 再次读取首个 double assert(rc == 1); printf("First value in the file again: %.1f\n", d); fclose(fp); // 演示错误处理 rc = fsetpos(stdin, &pos); if(rc) perror("could not fsetpos stdin"); }
输出:
First value in the file: 1.1 First value in the file again: 1.1 could not fsetpos stdin: Illegal seek
引用
- C11 standard (ISO/IEC 9899:2011):
- 7.21.9.1 The fgetpos function (p: 336)