fgetpos : 记录流或文件中的位置

概要

#include <stdio.h>
int fgetpos(FILE *fp, fpos_t *pos);
```### 描述

FILE 类型的对象可以具有一个“位置”，用于记录程序已经读取了多少文件内容。许多 stdio 函数依赖于该位置，并且许多函数会将其作为副作用进行改变。

您可以使用 fgetpos 来报告由 fp 标识的文件的当前位置；fgetpos 将在 *pos 处写入一个表示该位置的值。之后，您可以结合 fsetpos 使用该值将文件返回到此位置。

在当前的实现中，fgetpos 仅使用字符计数来表示文件位置；这与 ftell 返回的数字相同。### 返回值

fgetpos 成功时返回 0。如果 fgetpos 失败，结果为 1。当在不支持定位的流上操作时会发生失败；全局 errno 会通过值 ESPIPE 指示此情况。

---

**权威来源**: BUSMASTER DITA help source `fgetpos.dita`, compiled into `BUSMASTER.CHM` with the application.