setbuf

void setbuf( FILE* stream, char* buffer );

void setbuf( FILE* restrict stream, char* restrict buffer );

#define BUFSIZ  /* unspecified */

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

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

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

参数

注释

若 BUFSIZ 不是合适的缓冲区大小，可使用 setvbuf 更改它。

setvbuf 也应被用于检测错误，因为 setbuf 不指示成功或失败。

此函数仅在 stream 与一个打开的文件关联之后，但在任何其他操作（除了对 setbuf/setvbuf 的失败调用）之前使用。

常见错误是将 stdin 或 stdout 的缓冲区设置为一个生命周期在程序结束前结束的数组：

int main(void)
{
    char buf[BUFSIZ];
    setbuf(stdin, buf);
} // lifetime of buf ends, undefined behavior

示例

#include <stdio.h>
#include <threads.h>

int main(void)
{
    setbuf(stdout, NULL); // unbuffered stdout
    putchar('a'); // 'a' appears immediately if stdout is unbuffered
    thrd_sleep(&(struct timespec){ .tv_sec = 1 }, NULL); // sleep 1 sec
    putchar('b');
}

ab

引用

参阅