fread

Articolo
03/05/2013

legge i dati da un flusso.

size_t fread( 
   void *buffer,
   size_t size,
   size_t count,
   FILE *stream 
);

Parametri

buffer
percorso di archiviazione per i dati.
size
Dimensione elemento in byte.
count
Numero massimo di elementi da leggere.
stream
puntatore a FILE struttura.

Valore restituito

fread restituisce il numero di elementi completi letti effettivamente da, che possono essere minore count se si verifica un errore o se la fine del file viene rilevata prima di raggiungere count*.* utilizzare feof o ferror eseguire per distinguere un errore di lettura da uno stato di fine file.se size o count è 0, fread restituisce 0 e il contenuto del buffer è rimasto invariato.se stream o buffer è un puntatore null, fread richiama il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, set di questa funzione errno in EINVAL e restituisce 0.

vedere _doserrno, errno, _sys_errlist e _sys_nerr per ulteriori informazioni su questi e su altri, codici di errore.

Note

fread la funzione legge fino a count elementi di size byte input stream e li archivia in buffer*.* Il puntatore del file associato stream (se c " è uno) viene aumentato dal numero di byte letti effettivamente da.Se il flusso specificato aperto in modalità testo, le coppie di ritorno a capo-avanzamento righe vengono sostituite con i singoli caratteri di avanzamento riga.La sostituzione non ha effetto sul puntatore del file o il valore restituito.La posizione del puntatore del file è indeterminata se si verifica un errore.Il valore di un elemento parzialmente lettura non può essere specificato.

Questa funzione viene bloccato da altri thread.Se è necessaria una versione non di blocco, utilizzare _fread_nolock.

Requisiti

Funzione	Intestazione di associazione
fread	<stdio.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

// crt_fread.c
// This program opens a file named FREAD.OUT and
// writes 25 characters to the file. It then tries to open
// FREAD.OUT and read in 25 characters. If the attempt succeeds,
// the program displays the number of actual items read.
 
#include <stdio.h>

int main( void )
{
   FILE *stream;
   char list[30];
   int  i, numread, numwritten;

   // Open file in text mode:
   if( fopen_s( &stream, "fread.out", "w+t" ) == 0 )
   {
      for ( i = 0; i < 25; i++ )
         list[i] = (char)('z' - i);
      // Write 25 characters to stream 
      numwritten = fwrite( list, sizeof( char ), 25, stream );
      printf( "Wrote %d items\n", numwritten );
      fclose( stream );

   }
   else
      printf( "Problem opening the file\n" );

   if( fopen_s( &stream, "fread.out", "r+t" ) == 0 )
   {
      // Attempt to read in 25 characters 
      numread = fread( list, sizeof( char ), 25, stream );
      printf( "Number of items read = %d\n", numread );
      printf( "Contents of buffer = %.25s\n", list );
      fclose( stream );
   }
   else
      printf( "File could not be opened\n" );
}