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

CKTIS / C

setvbuf — конфигуриране на буферирането на поток

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

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

Извикайте setvbuf от <stdio.h> след отваряне на потока и преди каквато и да е друга операция върху него; изключение е неуспешно извикване на setvbuf.

mode: _IOFBF — пълно буфериране, _IOLBF — буфериране по редове, _IONBF — без буфериране. Връщаната стойност 0 означава успех; ненулева стойност означава невалиден режим или неизпълнена заявка.

При buf != NULL size задава размера на масива; библиотеката може да използва този масив. Запазете го до затварянето на потока; съдържанието му не е определено. При buf == NULL библиотеката може да използва size при заделянето на буфер.

Примерът затваря stream, преди локалният buffer да престане да съществува. Напускането на блока без затваряне на потока би довело до неопределено поведение.

Примери

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    char buffer[BUFSIZ];
    FILE *stream = tmpfile();
    if (stream == NULL)
        return EXIT_FAILURE;

    if (setvbuf(stream, buffer, _IOFBF, sizeof buffer) != 0) {
        fclose(stream);
        return EXIT_FAILURE;
    }

    int failed = fputs("Hello\n", stream) == EOF;
    if (fclose(stream) == EOF)
        failed = 1;
    if (failed)
        return EXIT_FAILURE;

    return puts("OK") == EOF ? EXIT_FAILURE : EXIT_SUCCESS;
}

Резултат

OK

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

Източници