setbuf

Устанавливает внутренний буфер для использования в операциях потока. Он должен быть длиной не менее BUFSIZ символов.

Если buffer не является нулевым указателем, эквивалентно setvbuf ( stream, buffer, _IOFBF , BUFSIZ ) .

Если buffer является нулевым указателем, эквивалентно вызову setvbuf ( stream, NULL , _IONBF , 0 ) , что отключает буферизацию.

Параметры

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

Нет.

Примечания

Если BUFSIZ не является подходящим размером буфера, setvbuf может быть использована для его изменения.

setvbuf также следует использовать для обнаружения ошибок, поскольку setbuf не указывает на успех или неудачу.

Эта функция может использоваться только после того, как stream был ассоциирован с открытым файлом, но до любой другой операции (кроме неудачного вызова setbuf / setvbuf ).

Распространённая ошибка — установка буфера stdin или stdout на массив, время жизни которого заканчивается до завершения программы:

int main(void) {
    char buf[BUFSIZ];
    setbuf(stdin, buf);
} // время жизни buf завершается, неопределенное поведение

Пример

#include <stdio.h>
#include <threads.h>
int main(void)
{
    setbuf(stdout, NULL); // unbuffered stdout
    putchar('a'); // 'a' appears immediately if stdout is unbuffered
    thrd_sleep(&(struct timespec){.tv_sec=1}, NULL); // sleep 1 sec
    putchar('b'); 
}

ab

Ссылки

Смотрите также