CKTIS / C
setbuf — настройване на буферирането на поток
Функцията `setbuf` от `<stdio.h>` заявява пълно буфериране, ако `buf` не е `NULL`, или работа без буфериране, ако `buf` е `NULL`. Реализацията може да използва подадения масив, но не е длъжна. Функцията не съобщава дали заявката е изпълнена.
Версия: C23; repository compiler flag, production runtime not attested
Синтаксис
#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);setbuf(stream, buf) заявява режим на буфериране за отворен поток. Ако buf не е NULL, функцията заявява пълно буфериране (_IOFBF) с размер BUFSIZ. Реализацията може да използва подадения масив като буфер, но не е длъжна. Подаването на NULL заявява работа без буфериране (_IONBF).
Извикайте функцията преди всяка друга операция с потока; изключение е неуспешно извикване на setvbuf. Ако buf не е NULL, той трябва да сочи към масив с поне BUFSIZ байта, в който може да се записва и който съществува до затварянето на потока. Съдържанието на масива не е специфицирано.
Функцията връща void и затова не може да съобщи дали заявката е изпълнена. setvbuf връща код за състоянието, позволява избор на размер на буфера и поддържа буфериране по редове (_IOLBF).
Примери
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
static char buffer[BUFSIZ];
setbuf(stdout, buffer);
if (puts("Hello") == EOF) {
return EXIT_FAILURE;
}
if (fflush(stdout) == EOF) {
return EXIT_FAILURE;
}
return EXIT_SUCCESS;
}Резултат
Hello
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.