C语言setbuf()函数：把缓冲区与流相关联

头文件：#include <stdio.h>

函数setbuf()用于将指定缓冲区与特定的文件流相关联，实现操作缓冲区时直接操作文件流的功能。其原型如下：
    void setbuf(FILE * stream, char * buf);

【参数】stream为文件流指针，buf为缓冲区的起始地址。

该函数涉及流和缓冲区的知识，请参考C语言流和缓冲区（缓存）专题。

如果参数buf 为NULL 指针，则为无缓冲，setbuf()相当于调用setvbuf(stream, buf, buf ? _IOFBF : _IONBF, BUFSIZE)，请参考C语言setvbuf()函数。

setbuf()和setvbuf()函数的实际意义在于：用户打开一个文件后，可以建立自己的文件缓冲区，而不必使用fopen()函数打开文件时设定的默认缓冲区。这样就可以让用户自己来控制缓冲区，包括改变缓冲区大小、定时刷新缓冲区、改变缓冲区类型、删除流中默认的缓冲区、为不带缓冲区的流开辟缓冲区等。

说明：在打开文件流后，读取内容之前，可以调用setbuf()来设置文件流的缓冲区（而且必须是这样）。

【实例】观察缓冲区与流关联后的影响。

#include <stdio.h>  
char outbuf[BUFSIZ]; 
int main(void) 
{ 
    setbuf(stdout, outbuf);  // 把缓冲区与流相连
    puts("This is a test of buffered output.\n");
    puts(outbuf);
    fflush(stdout);  // 刷新
    puts(outbuf);  // 输出
    return 0; 
}

输出结果：

程序先把outbuf与输出流相连，然后输出一个字符串，这时因为缓冲区已经与流相连，所以outbuf中也保存着这个字符串，紧接着puts函数又输出一遍，所以现在outbuf中保存着两个一样的字符串。刷新输出流之后，再次puts，则又输出两个字符串。