Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

setvbuf — nastavení vyrovnávací paměti proudu

setvbuf vybírá režim vyrovnávací paměti otevřeného proudu před dalšími operacemi a umožňuje použít vlastní vyrovnávací paměť dodanou volajícím.

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

Syntaxe

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

Volání setvbuf z <stdio.h> proveďte po otevření proudu a před jakoukoli další operací s ním; výjimkou je neúspěšné volání setvbuf.

mode: _IOFBF — úplné vyrovnávání, _IOLBF — řádkové vyrovnávání, _IONBF — bez vyrovnávání. Návratová hodnota 0 znamená úspěch; nenulová hodnota znamená neplatný režim nebo nesplněný požadavek.

Pokud buf != NULL, size udává velikost pole; knihovna může toto pole použít. Ponechte je platné až do uzavření proudu; jeho obsah není určen. Pokud buf == NULL, knihovna může size využít při alokaci vyrovnávací paměti.

Příklad uzavře stream dříve, než přestane existovat lokální buffer. Opuštění bloku bez uzavření proudu by způsobilo nedefinované chování.

Příklady

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

Výsledek

OK

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje