©
Ce document utiliseManuel du site Web PHP chinoisLibérer
在头文件 |
|
|
---|---|---|
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以来) |
stream
如参数所示,更改给定文件流的缓冲模式mode
。此外,
如果buffer
是空指针,则调整内部缓冲区的大小size
。
如果buffer
不是空指针,则指示流使用用户提供的大小size
开始的缓冲区buffer
。流必须fclose
在数组生命周期buffer
结束之前关闭(with )。成功调用数组后的内容setvbuf
是不确定的,并且任何尝试使用它都是未定义的行为。
流 |
- |
用于设置缓冲区的文件流或空指针仅用于更改大小和模式 |
||||||
---|---|---|---|---|---|---|---|---|
缓冲 |
- |
指向要使用的流的缓冲区 |
||||||
模式 |
- |
缓冲模式使用。它可以是以下值之一:_IOFBF完全缓冲_IOLBF行缓冲_IONBF无缓冲 |
_IOFBF |
完全缓冲 |
_IOLBF |
行缓冲 |
_IONBF |
没有缓冲 |
_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通常会提供更好的估计。
改变缓冲区大小的一个用例是知道更好的大小。
#include#include #include int main(void){ FILE* fp = fopen("test.txt", "r"); if(fp == NULL) { perror("fopen"); return 1; } struct stat stats; if(fstat(fileno(fp), &stats) == -1) { // POSIX only perror("fstat"); return 1; } 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 1; } int ch; while((ch=fgetc(fp)) != EOF); // read entire file: use truss/strace to // observe the read(2) syscalls used fclose(fp);}
可能的输出:
BUFSIZ is 8192, but optimal block size is 65536
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函数