C语言的setvbuf函数:设置文件流的缓冲区

时间:2021-09-02 00:52:46
头文件:#include <stdio.h>

函数setvbuf()用来设定文件流的缓冲区,其原型为:
    int setvbuf(FILE * stream, char * buf, int type, unsigned size);

【参数】stream为文件流指针,buf为缓冲区首地址,type为缓冲区类型,size为缓冲区内字节的数量。

参数类型type说明如下:
  • _IOFBF (满缓冲):当缓冲区为空时,从流读入数据。或当缓冲区满时,向流写入数据。
  • _IOLBF (行缓冲):每次从流中读入一行数据或向流中写入—行数据。
  • _IONBF (无缓冲):直接从流中读入数据或直接向流中写入数据,而没有缓冲区。

【返回值】成功返回0,失败返回非0。

该函数涉及流和缓冲区的知识,请参考 C语言流和缓冲区(缓存) 专题。

如果您只是想简单的操作缓冲区,还可以使用setbuf()函数,请查看: C语言setbuf()函数

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

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

【实例】为文件设置特殊类型缓冲区。

 
  
  1. #include <stdio.h>
  2. int main(void)
  3. {
  4. FILE *input, *output;
  5. char bufr[512];
  6. input = fopen("file.in", "w+"); /*打开文件*/
  7. output = fopen("file.out", "w");
  8. if (setvbuf(input, bufr, _IOFBF, 512) != 0) /*失败*/
  9. {
  10. printf("failed to set up buffer for input file\n");
  11. }
  12. else
  13. {
  14. printf("buffer set up for input file\n");
  15. }
  16. if (setvbuf(output, NULL, _IOLBF, 132) != 0) /*为流指定特殊的缓冲区*/
  17. {
  18. printf("failed to set up buffer for output file\n");
  19. }
  20. else
  21. {
  22. printf("buffer set up for output file\n");
  23. }
  24. fclose(input);
  25. fclose(output);
  26. return 0;
  27. }
运行结果:
Buffer set up for input file
Buffer set up for output file

程序先打开两个文件,分别设置缓冲区,根据返回值判定是否成功,最后使用fclose函数关闭这两个文件。