База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници