C 库函数 - setvbuf()

描述

C 库函数 int setvbuf(FILE stream, char buffer, int mode, size_t size) 定义流 stream 应如何缓冲。

声明

下面是 setvbuf() 函数的声明。

  1. int setvbuf(FILE *stream, char *buffer, int mode, size_t size)

参数

  • stream — 这是指向 FILE 对象的指针，该 FILE 对象标识了一个打开的流。
  • buffer — 这是分配给用户的缓冲。如果设置为 NULL，该函数会自动分配一个指定大小的缓冲。

  • mode — 这指定了文件缓冲的模式：

    模式描述
    _IOFBF全缓冲：对于输出，数据在缓冲填满时被一次性写入。对于输入，缓冲会在请求输入且缓冲为空时被填充。
    _IOLBF行缓冲：对于输出，数据在遇到换行符或者在缓冲填满时被写入，具体视情况而定。对于输入，缓冲会在请求输入且缓冲为空时被填充，直到遇到下一个换行符。
    _IONBF无缓冲：不使用缓冲。每个 I/O 操作都被即时写入。buffer 和 size 参数被忽略。

  • size —这是缓冲的大小，以字节为单位。

返回值

如果成功，则该函数返回 0，否则返回非零值。

实例

下面的实例演示了 setvbuf() 函数的用法。

  1. #include <stdio.h>
  3. int main()
  4. {
  6.    char buff[1024];
  8.    memset( buff, '\0', sizeof( buff ));
  10.    fprintf(stdout, "启用全缓冲\n");
  11.    setvbuf(stdout, buff, _IOFBF, 1024);
  13.    fprintf(stdout, "这里是 jishuchi.com\n");
  14.    fprintf(stdout, "该输出将保存到 buff\n");
  15.    fflush( stdout );
  17.    fprintf(stdout, "这将在编程时出现\n");
  18.    fprintf(stdout, "最后休眠五秒钟\n");
  20.    sleep(5);
  22.    return(0);
  23. }

让我们编译并运行上面的程序，这将产生以下结果。在这里，程序把缓冲输出保存到 buff，直到首次调用 fflush() 为止，然后开始缓冲输出，最后休眠 5 秒钟。它会在程序结束之前，发送剩余的输出到 STDOUT。

  1. 启用全缓冲
  2. 这里是 jishuchi.com
  3. 该输出将保存到 buff
  4. 这将在编程时出现
  5. 最后休眠五秒钟