setvbuf

在头文件 `<stdio.h>` 中定义
int setvbuf( FILE * stream, char * buffer, int mode, size_t size );		(直到 C99)
int setvbuf( FILE restrict stream, char restrict buffer, int mode, size_t size );		(自 C99)
#define _IOFBF /未指定/ #define _IOLBF /未指定/ #define _IONBF /未指定/

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

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

[编辑] 参数

stream

-

要设置缓冲区的文件流

buffer

-

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

mode

-

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

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

size

-

缓冲区大小

[编辑] 返回值

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++ 文档 for setvbuf

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

cppreference.com

命名空间

变体

视图

操作