Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

setvbuf — konfiguracja buforowania strumienia

setvbuf wybiera tryb buforowania otwartego strumienia przed innymi operacjami i pozwala dostarczyć własny bufor.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

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

setvbuf z <stdio.h> konfiguruj po otwarciu strumienia, przed jakąkolwiek inną operacją na nim; wyjątkiem jest nieudane wywołanie setvbuf.

mode: _IOFBF — pełne buforowanie, _IOLBF — buforowanie wierszowe, _IONBF — brak buforowania. Wynik 0 oznacza sukces; niezerowy — nieprawidłowy tryb lub niemożność spełnienia żądania.

Dla buf != NULL, size określa rozmiar tablicy, której biblioteka może użyć. Tablica musi istnieć do zamknięcia strumienia; jej zawartość jest nieokreślona. Dla buf == NULL biblioteka może wykorzystać size przy przydzielaniu bufora.

Przykład zamyka stream, zanim lokalny buffer przestanie istnieć. Samo wyjście z bloku bez zamknięcia strumienia powodowałoby niezdefiniowane zachowanie.

Przykłady

#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;
}

Wynik

OK

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła