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.