C 参考手册

定义于头文件 <stdio.h>
void setbuf( FILE          *stream, char          *buffer );
(C99 前)
void setbuf( FILE *restrict stream, char *restrict buffer );
(C99 起)

设置用于流操作的内部缓冲区。其长度至少应该为 BUFSIZ 个字符。

buffer 非空,则等价于 setvbuf(stream, buffer, _IOFBF, BUFSIZ)

buffer 为空,则等价于 setvbuf(stream, NULL, _IONBF, 0) ,这会关闭缓冲。

参数

stream - 要设置缓冲区的文件流
buffer - 指向文件流所用的缓冲区的指针。若提供 NULL ,则关闭缓冲。

返回值

无。

注意

BUFSIZ 不是适合的缓冲区大小,则能用 setvbuf 更改它。

setvbuf 亦应当用于检测错误,因为 setbuf 不指示成功或失败。

此函数仅可在已将 stream 关联到打开的文件后,但要在任何其他操作(除了对 setbuf/setvbuf 的失败调用)前使用。

一个常见错误是设置 stdin 或 stdout 的缓冲区为生存期在程序终止前结束的数组:

int main(void) {
    char buf[BUFSIZ];
    setbuf(stdin, buf);
} // buf 的生存期结束,未定义行为

示例

setbuf 可用于禁用要求立即输出的流的缓冲。

#include <stdio.h>
#include <threads.h>
 
int main(void)
{
    setbuf(stdout, NULL); // 无缓冲的 stdout
    putchar('a'); // 若 stdout 无缓冲,则 'a' 立即出现
    thrd_sleep(&(struct timespec){.tv_sec=1}, NULL); // 休眠 1 秒
    putchar('b'); 
}

输出:

ab

引用

  • 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

参阅

为文件流设置缓冲区和其大小
(函数)