setvbuf()

Связать буфер с потоком ввода-вывода

Прототип:

#include <stdio.h>
int setvbuf( FILE *fp,
char *buf,
int mode,
size_t size );

Аргументы:

fp
Поток, который необходимо связать с буфером.
buffer
NULL, либо указатель на буфер.
mode
Способ буферизации потока:
_IOFBF
ввод и вывод полностью буферизуются.
_IOLBF
вывод буферизуется построчно (буфер сбрасывается, когда записывается символ новой строки, когда буфер заполнен или когда запрашивается ввод).
_IONBF
ввод и вывод не буферизуются (сразу же осуществляется вывод).
size
Размер буфера.

Библиотека:

libc

Описание:

Функция setvbuf() связывает буфер с потоком ввода-вывода, указанным в fp. Вызывать функцию setvbuf() следует после открытия потока, но до выполнения операций чтения, записи или поиска.

Если buf не равен NULL, то указанная память будет использоваться вместо автоматически выделенного буфера.

Возвращаемое значение:

0
Успешное завершение.
EINVAL
Аргумент mode некорректен.
ENOMEM
Аргумент buf имеет значение NULL, size не равен 0, но при этом недостаточно памяти для выделения буфера.

Примеры:

#include <stdio.h>
#include <stdlib.h>
int main( void )
{
char *buf;
FILE *fp;
fp = fopen( "file", "r" );
buf = malloc( 1024 );
setvbuf( fp, buf, _IOFBF, 1024 );
/* work with fp */
...
fclose( fp );
/* This is OUR buffer, so we have to free it. Do that AFTER
* you've closed the file.c */
free( buf );
return (EXIT_SUCCESS);
}

Классификация:

ANSI, POSIX 1003.1

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Тематические ссылки:

fopen(), setbuf()




Предыдущий раздел: Описание API системной библиотеки