约 1573 字

约 8 分钟

#C 语言标准库函数 rewind

/*********************************************
 * @brief 将文件位置指示器的值重置为 0
 * @param fp 文件流
 * @param offset 偏移量
 * @param origin 原点
 * @return 文件流的指针
 ********************************************/
void rewind(FILE* fp);

说明

将文件位置指示器的值重置为 0(相当于 fseek(fp, 0, SEEK_SET)),并清除文件末尾和错误指示器。

参数

  • fp - 文件流

返回值

无

#示例

#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));

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

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

运行结果:

当前位置为 0
当前位置为 10
当前位置为 0

#推荐阅读

#参考标准

  • C23 standard (ISO/IEC 9899:2024):
    • 7.23.9.2 The rewind function (p: TBD)
  • C17 standard (ISO/IEC 9899:2018):
    • 7.21.9.2 The rewind function (p: 245)
  • C11 standard (ISO/IEC 9899:2011):
    • 7.21.9.2 The rewind function (p: 336-337)
  • C99 standard (ISO/IEC 9899:1999):
    • 7.19.9.2 The rewind function (p: 302-303)
  • C89/C90 standard (ISO/IEC 9899:1990):
    • 4.9.9.2 The rewind function

更新: 2025/10/25

作者: PlanC

创建: 2025/8/5