setbuf

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

void setbuf( FILE* restrict stream, char* restrict buffer );

#define BUFSIZ  /* unspecified */

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

Если buffer не равен null, эквивалентно setvbuf(stream, buffer, _IOFBF, BUFSIZ).

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

Параметры

Примечания

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

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

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

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

int main(void)
{
    char buf[BUFSIZ];
    setbuf(stdin, buf);
} // lifetime of buf ends, undefined behavior

Пример

#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

Ссылки

См. также