setbuf, setbuffer, setlinebuf, setvbuf - 流缓冲操作

http://cpp.ezbty.org/import_doc/linux_manpage/setvbuf.3.html

SETBUF

章节:Linux 程序员手册 (3)
更新:2008-06-26

到 易美翻译 翻译 本页


 

名字

setbuf, setbuffer, setlinebuf, setvbuf - 流缓存区操作

概要

#include 

void setbuf(FILE *stream, char *buf);

void setbuffer(FILE *stream, char *buf, size_t size);

void setlinebuf(FILE *stream);

int setvbuf(FILE *stream, char *buf, int mode, size_t size);

glibc 需要特性测试宏(参看 feature_test_macros(7)):

setbuffer(), setlinebuf():_BSD_SOURCE

描述

有三种缓存类型存在,不缓存,块缓存,和行缓存。当一个输出流是不缓存的,信息将在写入的同时在目标文件或终端显示;当它是块缓存,多个字符被缓存然后作为整体一块写入;当是行缓存,对输出流而言所有的数据都会被缓存直到遇到一个换行符,或者对于一个绑定到终端设置的输入流(典型地 stdin)所有数据也会缓存直到读到一个换行符。首次对文件进行 I/O 操作时,malloc(3) 被调用,并用于获得一个缓存区。如果一个流引用一个终端(就像 stdout 通常那样),则它是行缓存的。标准错误流 stderr 总是默认不缓存的。

setvbuf() 函数可能用于任何已经打开的流以更改它的缓存区。mode 参数必须是下面三个宏之一:

_IONBF
不缓存
_IOLBF
行缓存
_IOFBF
全缓存

除了是不存在的文件外,buf 参考应该指向一个至少有 size 个字节长度的缓存区;这个缓存将代替当前的缓存区。如果参数 buf 是 NULL,只要模式支持;一个新缓存区将用于下次读写操作。setvbuf() 函数只应该在刚打开一个流之后和执行任何其它操作之前使用。

其它三个调用,在功能上,只是 setvbuf() 调用的一个别名。setbuf() 函数事实上等价于调用

setvbuf(stream, buf, buf ? _IOFBF : _IONBF, BUFSIZ);

setbuffer() 函数也是相同的,只不过缓存区的大小是调用者提供的,而不是通过 BUFSIZ 来检测的。setlinebuf() 函数事实上等价于调用:

setvbuf(stream, (char *) NULL, _IOLBF, 0);

返回值

函数 setvbuf() 成功时返回 0。失败时它返回非零值(mode 无效或请求无法完成)。在失败时它设置 errno

其它函数没有返回值。

遵循于

setbuf() 和 setvbuf() 函数遵循于 C89 和 C99。

错误

setbuffer() 和 setlinebuf() 函数不能移植到 BSD 版本在 4.2BSD 之前,同时在 Linux 下它们从 libc 4.5.21 开始有效。在 4.2BSD 和 4.3BSD 系统里,setbuf() 使用一个不理想的缓存区尺寸并应该避免。

你必须保证 buf 指定的空间一直到 stream 关闭时都有效,这包括在退出时也一样。例如,下面的代码是无效的:

#include 

int
main(void)
{
    char buf[BUFSIZ];
    setbuf(stdin, buf);
    printf("Hello, world!\n");
    return 0;
}

 

你可能感兴趣的:(C/C++,Linux)