约 1894 字

约 9 分钟

#C 语言标准库函数 ftell

/*********************************************
 * @brief 获取文件当前位置
 * @param fp 文件流
 * @return 文件当前位置
 ********************************************/
int ftell(FILE* fp, long offset, int origin);

说明

获取文件位置指示器的值。

文本模式下(即不含 "b"),此函数的返回值由具体实现决定,并且没有意义;仅可作为 fseek 在 SEEK_SET 模式下的 offset 实参使用。

参数

  • fp - 文件流

返回值

  • 成功返回文件位置
  • 失败返回 -1

#示例

#include <stdio.h>

int main(void)
{
    // 打开文件
    FILE* fp = fopen("/tmp/test.txt", "wb+");

    if (fp == NULL)
    {
        perror("文件打开失败");
        return 1;
    }

    printf("当前位置为 %ld\n", ftell(fp));
    fputs("0123456789", fp);    // 写文件
    printf("当前位置为 %ld\n", ftell(fp));

    // 文件位置设为 文件开头 + 3
    ftell(fp, 3, SEEK_SET);
    printf("当前位置为 %ld\n", ftell(fp));

    // 文件位置设为 当前位置 + 5
    ftell(fp, 5, SEEK_CUR);
    printf("当前位置为 %ld\n", ftell(fp));

    // 文件位置设为 当前位置 - 1
    ftell(fp, -1, SEEK_CUR);
    printf("当前位置为 %ld\n", ftell(fp));

    // 文件位置设为 文件末尾 - 4
    ftell(fp, -4, SEEK_END);
    printf("当前位置为 %ld\n", ftell(fp));

    // 关闭文件
    fclose(fp);
    
    return 0;
}

运行结果:

当前位置为 0
当前位置为 10
当前位置为 3
当前位置为 8
当前位置为 7
当前位置为 6

#推荐阅读

#参考标准

  • C23 standard (ISO/IEC 9899:2024):
    • 7.21.9.4 The ftell function (p: TBD)
  • C17 standard (ISO/IEC 9899:2018):
    • 7.21.9.4 The ftell function (p: TBD)
  • C11 standard (ISO/IEC 9899:2011):
    • 7.21.9.4 The ftell function (p: 337-338)
  • C99 standard (ISO/IEC 9899:1999):
    • 7.19.9.4 The ftell function (p: 303-304)
  • C89/C90 standard (ISO/IEC 9899:1990):
    • 4.9.9.4 The ftell function

更新: 2025/10/25

作者: PlanC

创建: 2025/8/5