close

fclose

来自cppreference.com
< c | io
 
C
 
文件输入/输出
类型与对象
        
函数
文件访问
(C11)
(C11)  
(C95)
无格式输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)
(C95)
(C95)

有格式输入
(C99)(C99)(C99)(C11)(C11)(C11)
(C99)(C99)(C99)(C11)(C11)(C11)  
 
在标头 <stdio.h> 定义 
int fclose( FILE* stream );

关闭给定的文件流。冲入任何未写入的缓冲数据到 OS 。舍弃任何未读取的缓冲数据。

无论操作是否成功，流都不再关联到文件，且由 setbuf 或 setvbuf 分配的缓冲区若存在，则亦被解除关联，并且若使用自动分配则被解分配。

若在 fclose 返回后使用指针 stream 的值则行为未定义。

参数

stream - 需要关闭的文件流

返回值

成功时为 0，否则为 EOF。

示例

运行此代码
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    const char* fname = "/tmp/unique_name.txt"; // 或 tmpnam(NULL);
    int is_ok = EXIT_FAILURE;

    FILE* fp = fopen(fname, "w+");
    if (!fp)
    {
        perror("File opening failed");
        return is_ok;
    }
    fputs("Hello, world!\n", fp);
    rewind(fp);

    int c; // 注意：为处理 EOF 需要 int 而非 char
    while ((c = fgetc(fp)) != EOF) // 标准 C 的 I/O 文件读取循环
       putchar(c);

    if (ferror(fp))
        puts("读取时发生 I/O 错误");
    else if (feof(fp))
    {
        puts("成功抵达文件末尾");
        is_ok = EXIT_SUCCESS;
    }

    fclose(fp);
    remove(fname);
    return is_ok;
}

可能的输出： 

Hello, world!
成功抵达文件末尾

引用

  • C23 标准（ISO/IEC 9899:2024）：
  • 7.21.5.1 The fclose function （第 TBD 页）
  • C17 标准（ISO/IEC 9899:2018）：
  • 7.21.5.1 The fclose function （第 TBD 页）
  • C11 标准（ISO/IEC 9899:2011）：
  • 7.21.5.1 The fclose function （第 304 页）
  • C99 标准（ISO/IEC 9899:1999）：
  • 7.19.5.1 The fclose function （第 270 页）
  • C89/C90 标准（ISO/IEC 9899:1990）：
  • 4.9.5.1 The fclose function

参阅

(C11)
 打开文件
(函数) [编辑]
(C11)
 以不同名称打开既存的文件流
(函数) [编辑]
fclose 的 C++ 文档