Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

setbuf — ustawianie buforowania strumienia

Funkcja `setbuf` z `<stdio.h>` żąda pełnego buforowania, gdy `buf` nie jest `NULL`, albo pracy bez buforowania, gdy `buf` jest `NULL`. Implementacja może użyć przekazanej tablicy, ale nie musi. Funkcja nie informuje, czy żądanie zostało zrealizowane.

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

Składnia

#include <stdio.h>
void setbuf(FILE * restrict stream, char * restrict buf);

setbuf(stream, buf) służy do ustawiania buforowania otwartego strumienia. Gdy buf nie jest NULL, funkcja żąda pełnego buforowania (_IOFBF) z rozmiarem BUFSIZ. Implementacja może użyć przekazanej tablicy jako bufora, ale nie ma takiego obowiązku. Gdy buf jest NULL, funkcja żąda pracy bez buforowania (_IONBF).

Wywołaj funkcję przed wykonaniem jakiejkolwiek innej operacji na strumieniu; wyjątkiem jest nieudane wywołanie setvbuf. Jeśli buf nie jest NULL, musi wskazywać na zapisywalną tablicę o rozmiarze co najmniej BUFSIZ bajtów, która istnieje aż do zamknięcia strumienia. Zawartość tablicy jest nieokreślona.

Funkcja zwraca void, więc nie informuje, czy żądanie zostało zrealizowane. setvbuf zwraca kod wyniku, pozwala wybrać rozmiar bufora i udostępnia buforowanie wierszowe (_IOLBF).

Przykłady

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

Wynik

Hello

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

Źródła