fgetpos

来自cppreference.com
< c‎ | io
 
 
 
定义于头文件 <stdio.h>
int fgetpos( FILE          *stream, fpos_t          *pos );
(C99 前)
int fgetpos( FILE *restrict stream, fpos_t *restrict pos );
(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)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.19.9.1 The fgetpos function (p: 302)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.9.9.1 The fgetpos function

[编辑] 参阅

返回当前的文件位置指示值
(函数) [编辑]
将文件位置指示符移动到文件中的指定位置
(函数) [编辑]
将文件位置指示器移动到文件中的指定位置
(函数) [编辑]
fgetposC++ 文档