setvbuf

定义于头文件 `<stdio.h>`
int setvbuf( FILE * stream, char * buffer, int mode, size_t size );		(until C99)
int setvbuf( FILE restrict stream, char restrict buffer, int mode, size_t size );		(since C99)
#define _IOFBF /unspecified/ #define _IOLBF /unspecified/ #define _IONBF /unspecified/

更改给定文件流 stream 的缓冲模式，由参数 mode 指示。此外，

如果 buffer 是空指针，则将内部缓冲区大小调整为 size。
如果 buffer 不是空指针，则指示流使用用户提供的缓冲区，该缓冲区从 buffer 开始，大小为 size。流必须在指向 buffer 的数组的生命周期结束之前关闭（使用 fclose）。成功调用 setvbuf 后，数组的内容是不确定的，任何使用它的尝试都是未定义的行为。

[编辑] 参数

stream

-

要设置缓冲区的文件流

buffer

-

流要使用的缓冲区的指针，或者用于仅更改大小和模式的空指针

mode

-

要使用的缓冲模式。它可以是以下值之一

_IOFBF	全缓冲
_IOLBF	行缓冲
_IONBF	无缓冲

size

-

缓冲区的大小

[编辑] 返回值

0 成功时返回 0，失败时返回非零值。

[编辑] 注意

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

并非所有 size 字节都一定用于缓冲：实际缓冲区大小通常向下舍入为 2 的倍数、页面大小的倍数等。

在许多实现中，行缓冲仅适用于终端输入流。

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

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

默认缓冲区大小 BUFSIZ 预计是实现上文件 I/O 最有效的缓冲区大小，但 POSIX fstat 通常提供更好的估计。

[编辑] 示例

更改缓冲区大小的一个用例是在已知更好的大小时。（此示例使用一些 POSIX 函数，例如 fileno。另请参见 SO：#1 和 #2）。

运行此代码

// Make some POSIX functions, such as `int fileno(FILE*)`, visible:
#define _POSIX_SOURCE
 
#include <stdio.h>
#include <stdlib.h>
#include <sys/stat.h>
 
int main(void)
{
    FILE* fp = fopen("/tmp/test.txt", "w+");
    if (fp == NULL)
    {
        perror("fopen");
        return EXIT_FAILURE;
    }
 
    struct stat stats;
    if (fstat(fileno(fp), &stats) == -1) // POSIX only
    {
        perror("fstat");
        return EXIT_FAILURE;
    }
 
    printf("BUFSIZ is %d, but optimal block size is %ld\n", BUFSIZ, stats.st_blksize);
    if (setvbuf(fp, NULL, _IOFBF, stats.st_blksize) != 0)
    {
        perror("setvbuf failed"); // POSIX version sets errno
        return EXIT_FAILURE;
    }
 
    int ch;
    while((ch=fgetc(fp)) != EOF); // read entire file: use truss/strace to
                                  // observe the read(2) syscalls used
 
    fclose(fp);
    return EXIT_SUCCESS;
}

可能的输出

BUFSIZ is 8192, but optimal block size is 65536

[编辑] 参考文献

C17 标准 (ISO/IEC 9899:2018)

7.21.5.6 setvbuf 函数 (p: 225)

C11 标准 (ISO/IEC 9899:2011)

7.21.5.6 setvbuf 函数 (p: 308)

C99 标准 (ISO/IEC 9899:1999)

7.19.5.6 setvbuf 函数 (p: 273-274)

C89/C90 标准 (ISO/IEC 9899:1990)

4.9.5.6 setvbuf 函数

[编辑] 参见

setbuf	设置文件流的缓冲区 (函数) [编辑]
C++ 文档关于 setvbuf

编译器支持
语言
头文件
类型支持
程序工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

cppreference.cn

命名空间

变体

视图

操作