命名空间
变体
操作

setvbuf

来自 cppreference.cn
< c‎ | io
 
C
 
文件输入/输出
类型和对象
        
函数
文件访问
(C11)
(C11)  
(C95)
setvbuf

非格式化输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)
(C95)
(C95)

格式化输入
(C99)(C99)(C99)(C11)(C11)(C11)
(C99)(C99)(C99)(C11)(C11)(C11)  
 
定义于头文件 <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 The setvbuf function (p: 225)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.21.5.6 The setvbuf function (p: 308)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.19.5.6 The setvbuf function (p: 273-274)
  • C89/C90 标准 (ISO/IEC 9899:1990)
  • 4.9.5.6 The setvbuf function

[编辑] 参阅

 为文件流设置缓冲区
(函数) [编辑]
C++ 文档中关于setvbuf的内容
取自“https://cppreference.cn/mwiki/index.php?title=c/io/setvbuf&oldid=145360”