KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

setvbuf — streambuffering instellen

setvbuf kiest de bufferingsmodus van een geopende stream voordat er andere bewerkingen plaatsvinden en maakt het mogelijk een buffer van de aanroeper te gebruiken.

Versie: 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);

Roep setvbuf uit <stdio.h> aan nadat de stream is geopend en voordat er een andere bewerking op wordt uitgevoerd; een mislukte aanroep van setvbuf is de uitzondering.

mode: _IOFBF — volledige buffering, _IOLBF — regelbuffering, _IONBF — geen buffering. Retourwaarde 0 betekent succes; een waarde ongelijk aan nul betekent een ongeldige modus of een verzoek waaraan niet kon worden voldaan.

Als buf != NULL, geeft size de grootte van de array aan; de bibliotheek mag die array gebruiken. Houd de array in leven totdat de stream is gesloten; de inhoud ervan is niet gespecificeerd. Als buf == NULL, mag de bibliotheek size gebruiken bij het toewijzen van een buffer.

Het voorbeeld sluit stream voordat de lokale buffer niet meer bestaat. Het blok verlaten zonder de stream te sluiten zou ongedefinieerd gedrag veroorzaken.

Voorbeelden

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

Resultaat

OK

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen