setbuf

setbuf

Функция            Назначает буфер для потока stream.

Синтаксис          #include <stdio.h>
                   void setbuf(FILE *stream, char *buf);

Файл, содержащий   stdio.h
прототип

Описание           Функция setbuf     выделяет    буфер    buf    для
                   использования в операциях  ввода/вывода  -  вместо
                   автоматически   выделяемого   буфера.   Он   будет
                   использоваться только после того, как данный поток
                   stream будет открыт.

                   При использовании функции  setbuf,  если  параметр
                   buf = NULL,  ввод/вывод производится без буфера; в
                   противном случае буфер используется.

                   Буфер должен быть длиной  BUFSIZE  байтов  (данная
                   константа определяется в файле stdio.h).

                   Стандартный ввод   и   вывод  stdin  и  stdout  не
                   используют   буферов,    если    они    не    были
                   переназначены;  в  противном случае,  ввод и вывод
                   производиться с буферизацией.

                   unbuffered (небуферизованный ввод/вывод) означает,
                   что   символы,  записываемые  в  поток,  поступают
                   непосредственно в файл или  на  устройство;  в  то
                   время  как  buffered  (буферизованный  ввод/вывод)
                   означает,  что  символы  накапливаются   и   затем
                   записываются, как блок.

                   Функция setbuf  может  привести  к  непредвиденным
                   результатам,  если  она  вызывается   для   потока
                   stream,  причем не следует немедленно за операцией
                   открытия или вызовом функции fseek.  Вызов функции
                   setbuf после того,  как поток stream обработан без
                   буферов, разрешен, и не вызовет ошибок.

                   Наиболее распространенной причиной ошибки является
                   размещение    буфера,    в    качестве   automatiс
                   (локальной) переменной  и  затем  попытка  закрыть
                   файл до выхода из функции,  в которой был объявлен
                   буфер.

Возвращаемое       Нет.
значение

Переносимость      Функция поддерживаются на системах UNIX и стан-
                   дартом ANSI C.

Смотрите также     fflush, fopen, fseek, setvbuf.

Пример:

#include<stdio.h>

/* BUFSIZE определено в stdio.h */
char buf[BUFSIZE];

int main(void)
{
   int i;
   /* подключить буфер к стандартному потоку */
   setbuf(stdout,buf);
   /* поместить в буфер символы */
   puts("Это тест буферизованного вывода.\n");
   puts("Этот вывод осуществляется в buf\n");
   puts("и вы ничего не увидите, пока буффер не заполнится\n");
   puts("или вы не сбросите его.\n");
   /* сбросить поток */
   fflush(stdout);
   return 0;
}