ftell : 返回流或文件中的位置

Synopsis

#include <stdio.h>
long ftell(FILE *fp);
```### Description

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

ftell 的结果是由 fp 标识的文件的当前位置。如果您记录了该结果，稍后可以将其与 fseek 结合使用，以将文件返回到此位置。

在当前的实现中，ftell 直接使用字符计数来表示文件位置；这与 fgetpos 所记录的数字相同。### Returns

如果可能，ftell 返回文件位置。如果无法做到这一点，它将返回 -1L。在不支持定位的流上会发生失败；全局 errno 会使用值 ESPIPE 来指示此情况。

---

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