#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

#推荐阅读

• C 语言标准库函数 fseek
• C 语言标准库函数 ftell
• rewind - cppreference

#参考标准

• 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