SETBUF(3S)
НАЗВАНИЕ
setbuf, setvbuf - назначение буферов для потока
СИНТАКСИС
#include <stdio.h>
void setbuf (stream, buf)
FILE *stream;
char *buf;
void setvbuf (stream, buf, type, size)
FILE *stream;
char *buf;
int type, size;
ОПИСАНИЕ
Функция setbuf может быть использована после открытия
потока, но перед тем, как выполнена первая из процедур
ввода/вывода. При этом массив, на который указывает аргумент buf, будет использоваться вместо автоматически
назначаемых буферов. Если значение buf равно NULL,
ввод/вывод будет полностью небуферизованным.
Требуемый размер буфера определяется константой BUFSIZ,
заданной во включаемом файле <stdio.h>:
char buf [BUFSIZ];
Функция setvbuf также может быть использована сразу
после открытия потока, но перед тем, как выполнена первая из процедур ввода/вывода. Аргумент type определяет
тип буферизации. Допустимы следующие типы буферизации,
описанные в <stdio.h>:
- _IOFBF
-
Полная буферизация ввода/вывода.
-
_IOLBF
-
Строчная буферизация вывода; буфер вывода выталкивается при выдаче символа перевода строки, заполнении буфера или запросе на ввод.
-
_IONBF
-
Полное отсутствие буферизации ввода/вывода.
Если значение buf не равно NULL, массив, на который
указывает buf, будет использоваться вместо автоматически назначаемых буферов. Аргумент size задает размер используемого буфера. Константа BUFSIZ, определенная во
включаемом файле <stdio.h>, является разумным значением
для размера буфера. Если ввод/вывод небуферизован, то
аргументы buf и size игнорируются.
По умолчанию вывод на терминал является строчно буферизованным, а весь остальной ввод/вывод буферизуется полностью.
СМ. ТАКЖЕ
fopen(3S), getc(3S), malloc(3C), putc(3S), stdio(3S).
ДИАГНОСТИКА
Если указано некорректное значение для аргументов type
или size, то функция setvbuf возвращает ненулевое значение. В противном случае результат равен 0.
ПРИМЕЧАНИЯ
Распространенной ошибкой является выделение под буфер
локальной переменной блока без закрытия потока при выходе из блока.