setbuf

Articolo
03/05/2013

Controlla la memorizzazione nel buffer del flusso.Questa funzione è deprecata; usare invece setvbuf.

void setbuf(
   FILE *stream,
   char *buffer 
);

Parametri

stream
Puntatore alla struttura FILE.
buffer
Buffer allocato dall'utente.

Note

La funzione setbuf controlla il buffer per stream.L'argomento stream deve fare riferimento a un file aperto che non è stato letto o scritto.Se l'argomento buffer è NULL, il flusso è senza buffer.In caso contrario, il buffer deve puntare a una matrice di caratteri di lunghezza BUFSIZ, dove BUFSIZ è la dimensione del buffer come definito in. STDIO.H.Il buffer definito dall'utente, anziché un buffer allocato predefinito per il flusso specificato, viene utilizzato per il buffering di I/O.Il flusso stderr è senza buffer per impostazione predefinita, ma è possibile utilizzare setbuf per assegnare buffer su stderr.

setbuf è stato sostituito da setvbuf, che è la procedura consigliata per il nuovo codice.setbuf viene mantenuto per compatibilità con il codice esistente.

Requisiti

Routine	Intestazione obbligatoria
setbuf	<stdio.h>

Per ulteriori informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.

Esempio

// crt_setbuf.c
// compile with: /W3
// This program first opens files named DATA1 and
// DATA2. Then it uses setbuf to give DATA1 a user-assigned
// buffer and to change DATA2 so that it has no buffer.
 
#include <stdio.h>

int main( void )
{
   char buf[BUFSIZ];
   FILE *stream1, *stream2;

   fopen_s( &stream1, "data1", "a" );
   fopen_s( &stream2, "data2", "w" );

   if( (stream1 != NULL) && (stream2 != NULL) )
   {
      // "stream1" uses user-assigned buffer:
      setbuf( stream1, buf ); // C4996
      // Note: setbuf is deprecated; consider using setvbuf instead
      printf( "stream1 set to user-defined buffer at: %Fp\n", buf );

      // "stream2" is unbuffered
      setbuf( stream2, NULL ); // C4996
      printf( "stream2 buffering disabled\n" );
      _fcloseall();
   }
}