Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

setvbuf — nastavenie vyrovnávacej pamäte prúdu

setvbuf vyberá režim vyrovnávacej pamäte otvoreného prúdu pred ďalšími operáciami a umožňuje použiť vlastnú vyrovnávaciu pamäť dodanú volajúcim.

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

Syntax

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

Volanie setvbuf z <stdio.h> vykonajte po otvorení prúdu a pred akoukoľvek ďalšou operáciou s ním; výnimkou je neúspešné volanie setvbuf.

mode: _IOFBF — úplné vyrovnávanie, _IOLBF — riadkové vyrovnávanie, _IONBF — bez vyrovnávania. Návratová hodnota 0 znamená úspech; nenulová hodnota znamená neplatný režim alebo nesplnenú požiadavku.

Ak buf != NULL, size udáva veľkosť poľa; knižnica môže toto pole použiť. Ponechajte ho platné až do zatvorenia prúdu; jeho obsah nie je určený. Ak buf == NULL, knižnica môže size využiť pri alokácii vyrovnávacej pamäte.

Príklad zatvorí stream skôr, než prestane existovať lokálny buffer. Opustenie bloku bez zatvorenia prúdu by spôsobilo nedefinované správanie.

Prí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ýsledok

OK

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje