Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

setvbuf — configurare il buffering di uno stream

setvbuf seleziona la modalità di buffering di uno stream aperto prima di altre operazioni e consente di fornire un buffer personalizzato.

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

Sintassi

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

Chiama setvbuf da <stdio.h> dopo aver aperto lo stream e prima di qualsiasi altra operazione su di esso; fa eccezione una chiamata a setvbuf non riuscita.

mode: _IOFBF — buffering completo, _IOLBF — buffering per righe, _IONBF — nessun buffering. Il valore restituito 0 indica successo; un valore diverso da zero indica una modalità non valida o una richiesta non soddisfatta.

Se buf != NULL, size specifica la dimensione dell’array; la libreria può usare quell’array. Mantienilo in vita fino alla chiusura dello stream; il suo contenuto non è specificato. Se buf == NULL, la libreria può usare size quando alloca un buffer.

L’esempio chiude stream prima che il buffer locale cessi di esistere. Uscire dal blocco senza chiudere lo stream causerebbe un comportamento indefinito.

Esempi

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

Risultato

OK

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti