命名空间
变体
操作

fgetpos

来自 cppreference.com
< c‎ | io
 
 
文件输入/输出
类型和对象
函数
文件访问
直接输入/输出
无格式输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)
格式化输入
(C99)(C99)(C99)(C11)(C11)(C11)     
 
定义在头文件 <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)
{
    // prepare a file holding 4 values of type 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);
 
    // demo using fsetpos to return to the beginning of a file
    fp = fopen("test.bin", "rb");
    fpos_t pos;
    fgetpos(fp, &pos);               // store start of file in pos
    double d;
    rc = fread(&d, sizeof d, 1, fp); // read the first double
    assert(rc == 1);
    printf("First value in the file: %.1f\n", d);
    fsetpos(fp,&pos);                 // move file position back to the start of the file
    rc = fread(&d, sizeof d, 1, fp);  // read the first double again
    assert(rc == 1);
    printf("First value in the file again: %.1f\n", d);
    fclose(fp);
 
    // demo error handling
    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 标准 (ISO/IEC 9899:2011)
  • 7.21.9.1 fgetpos 函数 (p: 336)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.19.9.1 fgetpos 函数 (p: 302)
  • C89/C90 标准 (ISO/IEC 9899:1990)
  • 4.9.9.1 fgetpos 函数

[编辑] 参见

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