KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

setbuf — buffering van een stream instellen

Met `setbuf` uit `<stdio.h>` vraagt u volledige buffering aan als `buf` niet `NULL` is, of ongebufferde werking als `buf` `NULL` is. De implementatie mag de meegegeven array gebruiken, maar hoeft dat niet te doen. De functie meldt niet of het verzoek is ingewilligd.

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

Syntax

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

Met setbuf(stream, buf) vraagt u een bufferstand aan voor een geopende stream. Als buf niet NULL is, vraagt u volledige buffering (_IOFBF) met grootte BUFSIZ aan. De implementatie mag de meegegeven array als buffer gebruiken, maar hoeft dat niet te doen. Met NULL vraagt u ongebufferde werking (_IONBF) aan.

Roep de functie aan voordat u een andere bewerking op de stream uitvoert; een mislukte aanroep van setvbuf is de enige uitzondering. Als buf niet NULL is, moet het verwijzen naar een beschrijfbare array van minstens BUFSIZ bytes die blijft bestaan totdat de stream is gesloten. De inhoud van de array is niet gespecificeerd.

De functie retourneert void en kan dus niet melden of het verzoek is ingewilligd. setvbuf retourneert een statuscode, laat u de buffergrootte kiezen en ondersteunt regelbuffering (_IOLBF).

Voorbeelden

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

Resultaat

Hello

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