# C 语言标准库函数 setbuf

/*********************************************
 * @brief 设置缓冲区
 * @param fp 文件流
 * @param buffer 缓冲区
 ********************************************/
void setbuf(FILE* restrict fp, char* restrict buffer);

!subtitle:说明

设置缓冲区。

如果参数 buffer 为 NULL，则关闭缓冲。

!subtitle:参数

• fp - 要操作的文件流

• buffer - 缓冲区，不可少于 100 个字节

!subtitle:返回值

无

# 示例

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    setbuf(stdout, NULL);   // 关闭 stdout 的缓冲
    printf("Hello World");  // 输出
    quick_exit(0);          // quick_exit 不会自动冲洗 IO 流

    return 0;
}

运行结果：

Hello World

说明：

示例中通过调用 quick_exit 函数快速退出，此时不会自动冲洗文件流。

由于手动调用 setbuf 关闭了 stdout 的缓冲，因此运行此示例时可以看见打印。

如果 stdout 使用缓冲，将看不见任何打印。

# 推荐阅读

• C 语言标准库函数 setvbuf

• C 语言标准库函数 fflush

• setbuf - cppreference

• setbuf - POSIX

# 参考标准

• C17 standard (ISO/IEC 9899:2018):

  • 7.21.5.5 The setbuf function (p: 225)

• C11 standard (ISO/IEC 9899:2011):

  • 7.21.5.5 The setbuf function (p: 307-308)

• C99 standard (ISO/IEC 9899:1999):

  • 7.19.5.5 The setbuf function (p: 273)

• C89/C90 standard (ISO/IEC 9899:1990):

  • 4.9.5.5 The setbuf function