Provided by: manpages-zh_1.6.3.2-1_all bug

NAME

       setbuf, setbuffer, setlinebuf, setvbuf - 流緩衝操作

SYNOPSIS 總覽

       #include <stdio.h>

       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);

DESCRIPTION 描述

       有三種類型的緩衝策略,它們是無緩衝,塊緩衝和行緩衝。當輸出流無緩衝時,信息在寫的同時出現於
       目標文件或終端上;當是塊緩衝時,字符被暫存,然後一起寫入;當是行緩衝時,字符被暫存,直到要
       輸出一個新行符,或者從任何與終端設備連接的流中   (典型的是  stdin)  讀取輸入時才輸出。函數
       fflush(3) 可以用來強制提前輸出。(參見 fclose(3)) 通常所有文件都是塊緩衝的。當文件 I/O 操作
       在文件上發生時,將調用  malloc(3)  ,獲得一個緩衝。如果流指向一個終端  (通常 stdout 都是這
       樣),那麼它是行緩衝的。標準錯誤流 stderr 默認總是無緩衝的。

       函數 setvbuf 可以用在任何打開的流上,改變它的緩衝。參數 mode 必須是下列三個宏之一:

              _IONBF 無緩衝

              _IOLBF 行緩衝

              _IOFBF 完全緩衝

       除非是無緩衝的文件,否則參數 buf 應當指向一個長度至少爲 size  字節的緩衝;這個緩衝將取代當
       前的緩衝。如果參數 bufNULL ,只有這個模式會受到影響;下次 read 或 write 操作還將分配一
       個新的緩衝。函數 setvbuf 只能在打開一個流,還未對它進行任何其他操作之前使用。

       其他三個函數調用是函數 setvbuf 的別名,函數 setbuf 與使用下列語句完全等價:

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

       函數  setbuffer   與此相同,但是緩衝的長度由用戶決定,而不是由默認值   BUFSIZ   決定。函數
       setlinebuf 與使用下列語句完全等價:

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

RETURN VALUE 返回值

       函數  setvbuf  成功執行時返回 0。它失敗時可能返回任何值,但是當 It can return any value on
       failure, but returns nonzero when mode  不正確,或者不能實現請求時,必須返回非零值。它在失
       敗時可能設置 errno 。其他函數沒有返回值。

CONFORMING TO 標準參考

       函數 setbufsetvbuf 遵循 ANSI X3.159-1989 (``ANSI C'') 標準。

BUGS

       函數  setbuffersetlinebuf  無法移植到  4.2BSD  之前的 BSD 版本,在 Linux 中僅在 libc
       4.5.21 之後的系統中可用。在 4.2BSD 和 4.3BSD 系統中, setbuf  總是使用非最優的緩衝大小,應
       當避免使用它。

       在 stream 被關閉時,必須確保 buf 和它指向的空間仍然存在。這通常發生在程序終止時。

       例如,下列調用是非法的:

       #include <stdio.h>
       int main()
       {
           char buf[BUFSIZ];
           setbuf(stdin, buf);
           printf("Hello, world!\n");
           return 0;
       }

SEE ALSO 參見

       fclose(3), fflush(3), fopen(3), fread(3), malloc(3), printf(3), puts(3)

       本頁面中文版由中文 man 手冊頁計劃提供。
       中文 man 手冊頁計劃:https://github.com/man-pages-zh/manpages-zh