Linux API. Исчерпывающее руководство полностью

Аргумент stream идентифицирует файловый поток, буферизация которого должна быть изменена. После того как поток открыт, функция setvbuf() может быть запущена до вызова в отношении этого потока любой другой функции stdio. Вызов setvbuf() влияет на поведение всех последующих stdio-операций, выполняемых над указанным потоком.

Потоки, используемые библиотекой stdio, не нужно путать с фреймворком STREAMS для System V, который не реализован в «ванильном» ядре Linux.

Аргументы buf и size определяют буфер, используемый для потока, идентифицируемого аргументом stream. Эти аргументы могут быть указаны двумя способами.

• Если buf имеет ненулевое значение, то он указывает на блок памяти с размером в байтах, заданным в аргументе size. Этот блок будет использоваться в качестве буфера для stream. Поскольку буфер, на который указывает buf, затем используется библиотекой stdio, он должен быть либо статически, либо динамически выделен на куче (с помощью malloc() или подобной ей функции). Он не может быть выделен на стеке локальной переменной функции, поскольку это вызовет полный хаос, когда произойдет возврат из функции и будет освобожден соответствующий ей кадр стека.

• Если buf имеет значение NULL, библиотека stdio автоматически выделяет буфер для использования с потоком stream (если только не будет выбран рассматриваемый далее ввод-вывод без применения буфера). В SUSv3 допускается, но не требуется использование реализацией аргумента size для определения размера этого буфера. В glibc-реализации в данном случае аргумент size игнорируется.

Аргумент mode указывает на тип буферизации и имеет одно из следующих значений.

• _IONBF — не выполнять буферизацию ввода-вывода. Каждый вызов библиотеки stdio приводит к немедленному системному вызову write() или read(). Аргументы buf и size игнорируются и могут быть указаны как NULL и 0 соответственно. Это настройка по умолчанию для stderr, что гарантирует немедленное появление сообщения об ошибке.

• _IOLBF — использовать построчную буферизацию ввода-вывода. Этот флаг задан по умолчанию для потоков, имеющих отношение к терминальным устройствам. Для выходных потоков данные буферизуются до тех пор, пока в выводе не появится символ новой строки (или пока не заполнится буфер). Для выходных потоков выполняется построчное считывание данных.

• _IOFBF — применять полностью буферизованный ввод-вывод. Данные считываются или записываются (с помощью вызовов read() или write()) блоками, равными размеру буфера. Для потоков, имеющих отношение к дисковым файлам, этот режим задан по умолчанию.

Использование setvbuf() продемонстрировано в следующем коде:

#define BUF_SIZE 1024

static char buf[BUF_SIZE];

if (setvbuf(stdout, buf, _IOFBF, BUF_SIZE)!= 0)

errExit("setvbuf");

Обратите внимание, что setvbuf() в случае ошибки возвращает ненулевое значение (не обязательно –1).

Функция setbuf() является надстройкой над setvbuf() и выполняет точно такую же задачу.

#include

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

За исключением того, что не возвращается результат функции, вызов setbuf(fp, buf) является эквивалентом такого вызова:

setvbuf(fp, buf, (buf!= NULL)? _IOFBF: _IONBF, BUFSIZ);

Для аргумента buf определяется либо значение NULL для отказа от буферизации, либо указатель на буфер из BUFSIZ байтов, выделяемый вызывающим кодом. (Константа BUFSIZ определена в . В реализации glibc она имеет весьма распространенное значение 8192.)

Функция setbuffer() аналогична функции setbuf(), но позволяет вызывающему коду указать размер буфера buf.

#define _BSD_SOURCE

#include

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

Вызов функции setbuffer(fp, buf, size) является эквивалентом следующего вызова:

setvbuf(fp, buf, (buf!= NULL)? _IOFBF: _IONBF, size);

Функция setbuffer() не определена в SUSv3, но доступна в большинстве реализаций UNIX.

Сброс буфера stdio

Независимо от текущего режима буферизации, в любое время можно принудительно записать данные, находящиеся в выходном потоке stdio (то есть сбросить буфер ядра на диск посредством write()), воспользовавшись библиотечной функцией fflush(). Она сбрасывает буфер вывода для указанного потока.

#include

int fflush(FILE *stream);

Возвращает при успешном завершении 0 или EOF при ошибке

Если для stream указано значение NULL, то fflush() сбрасывает на диск содержимое всех буферов stdio, которые связаны с потоками вывода.

Функция fflush() может также применяться к входному потоку. При этом отбрасывается весь буферизованный ввод. (Буфер будет заполнен заново при следующей попытке программы выполнить чтение из потока.)

Когда соответствующий поток закрывается, буфер stdio автоматически сбрасывается.