头文件:#include
函数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 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; }
输出结果:
This is a test of buffered output..
This is a test of buffered output..
This is a test of buffered output..
This is a test of buffered output..
程序先把outbuf与输出流相连,然后输出一个字符串,这时因为缓冲区已经与流相连,所以outbuf中也保存着这个字符串,紧接着puts函数又输出一遍,所以现在outbuf中保存着两个一样的字符串。刷新输出流之后,再次puts,则又输出两个字符串。