Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

Costanti di buffering di stdio

Le macro di <stdio.h> selezionano la modalità di buffering di uno stream e specificano la dimensione del buffer per setbuf. Non dare per scontati i loro valori numerici.

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);
void setbuf(FILE * restrict stream, char * restrict buf);

_IOFBF seleziona il buffering completo, _IOLBF il buffering per righe e _IONBF l’assenza di buffering. Sono argomenti mode di setvbuf. BUFSIZ specifica la dimensione del buffer per setbuf, è almeno 256 e non è una modalità.

Il buffering completo prevede trasferimenti a blocchi quando il buffer si riempie; quello per righe anche in corrispondenza di \n; gli stream senza buffer trasferiscono i dati il prima possibile. I dettagli dipendono dall’implementazione. fflush invia l’output in attesa all’ambiente, senza garantire che venga memorizzato in modo permanente sul disco.

Chiama setvbuf dopo aver aperto lo stream e prima di altre operazioni, tranne che dopo una chiamata non riuscita a setvbuf. Zero indica il successo. L’array fornito deve restare disponibile finché lo stream lo usa. setbuf(stream, buf) seleziona _IOFBF e BUFSIZ; setbuf(stream, NULL) seleziona _IONBF, senza segnalare errori.

Esempi

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    static char buffer[BUFSIZ];

    if (setvbuf(stdout, buffer, _IOFBF, sizeof buffer) != 0)
        return EXIT_FAILURE;
    if (fputs("Buffered output\n", stdout) == EOF)
        return EXIT_FAILURE;
    if (fflush(stdout) == EOF)
        return EXIT_FAILURE;
    return EXIT_SUCCESS;
}

Risultato

Buffered output

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