Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

setvbuf — nastavitev medpomnjenja toka

setvbuf izbere način medpomnjenja odprtega toka pred drugimi operacijami in omogoča uporabo medpomnilnika, ki ga zagotovi klicatelj.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

setvbuf iz <stdio.h> pokličite po odprtju toka in pred katero koli drugo operacijo na njem; izjema je neuspešen klic setvbuf.

mode: _IOFBF — polno medpomnjenje, _IOLBF — medpomnjenje po vrsticah, _IONBF — brez medpomnjenja. Vrnjena vrednost 0 pomeni uspeh; vrednost, ki ni nič, pomeni neveljaven način ali zahtevo, ki je ni bilo mogoče izpolniti.

Če velja buf != NULL, size določa velikost polja; knjižnica lahko uporabi to polje. Ohranite ga do zaprtja toka; njegova vsebina ni določena. Če velja buf == NULL, lahko knjižnica uporabi size pri dodeljevanju medpomnilnika.

Primer zapre stream, preden lokalni buffer preneha obstajati. Zapustitev bloka brez zaprtja toka bi povzročila nedefinirano vedenje.

Primeri

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

Rezultat

OK

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri