setbuf : 为文件或流指定完全缓冲

概要

#include <stdio.h>
void setbuf(FILE *fp, char *buf);
```### 描述

setbuf 指定对由 fp 标识的文件或流的输出应采用完全缓冲。此文件的所有输出将写入一个缓冲区（大小为 BUFSIZ，在 `stdio.h' 中指定）。仅当缓冲区已满，或者有输入操作介入时，输出才会传递给主机系统。

如果您愿意，可以通过将指向缓冲区的指针作为参数 buf 传递，来提供您自己的缓冲区。它的大小必须为 BUFSIZ。您也可以使用 NULL 作为 buf 的值，以指示 setbuf 函数自行分配缓冲区。### 警告

您只能在执行除打开文件之外的任何文件操作之前使用 setbuf。

如果您提供了非空的 buf，则必须确保在关闭由 fp 标识的流之前，关联的存储始终可用。### 返回值

setbuf 不返回结果。

---

**权威来源**: BUSMASTER DITA help source `setbuf.dita`, compiled into `BUSMASTER.CHM` with the application.