Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

setbuf — configurare il buffering di un flusso

`setbuf`, dichiarata in `<stdio.h>`, richiede il buffering completo se `buf` non è `NULL`, oppure il funzionamento senza buffering se `buf` è `NULL`. L’implementazione può usare l’array fornito, ma non è tenuta a farlo. La funzione non indica se la richiesta è stata soddisfatta.

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

Sintassi

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

setbuf(stream, buf) richiede una modalità di buffering per un flusso aperto. Se buf non è NULL, richiede il buffering completo (_IOFBF) con dimensione BUFSIZ. L’implementazione può usare l’array fornito come buffer, ma non è tenuta a farlo. Passare NULL richiede il funzionamento senza buffering (_IONBF).

Chiamare la funzione prima di qualsiasi altra operazione sul flusso; fa eccezione una chiamata a setvbuf non riuscita. Se buf non è NULL, deve puntare a un array scrivibile di almeno BUFSIZ byte che rimanga in vita fino alla chiusura del flusso. Il contenuto dell’array non è specificato.

La funzione restituisce void, quindi non può indicare se la richiesta è stata soddisfatta. setvbuf restituisce un codice di stato, consente di scegliere la dimensione del buffer e supporta il buffering per righe (_IOLBF).

Esempi

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

Risultato

Hello

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