fread_s

Legge i dati da un flusso.Questa versione di fread presenta miglioramenti della sicurezza, come descritto in Funzionalità di sicurezza in CRT.

size_t fread_s( 
   void *buffer,
   size_t bufferSize,
   size_t elementSize,
   size_t count,
   FILE *stream 
);

Parametri

• buffer
  Percorso di archiviazione per i dati.

• bufferSize
  Dimensione del buffer di destinazione in byte.

• elementSize
  Dimensione elemento da leggere in byte.

• count
  Numero massimo di elementi da leggere.

• stream
  Puntatore a una struttura di FILE .

Valore restituito

fread_s restituisce il numero (integer) elementi che sono stati illustrati nel buffer, che può essere meno che count se un errore di lettura o alla fine del file viene rilevato count prima che venga raggiunto.Utilizzare la funzione di ferror o di feof per distinguere un errore da uno stato di fine file.Se size o count è 0, fread_s restituisce 0 e il contenuto del buffer è rimasto invariato.Se stream o buffer è un puntatore null, fread_s richiamato il gestore non valido di parametro, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, set errno di questa funzione a EINVAL e restituisce 0.

Per ulteriori informazioni sui codici di errore, vedere _doserrno, errno, _sys_errlist e _sys_nerr.

Note

La funzione di fread_s legge fino agli elementi di count di byte di elementSizeinput stream e li archivia in buffer.Il puntatore del file associato a stream (se presente) viene aumentato dal numero di byte letti effettivamente.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

Per informazioni aggiuntive di compatibilità, vedere compatibilità.

Esempio

// crt_fread_s.c
// Command line: cl /EHsc /nologo /W4 crt_fread_s.c
//
// This program opens a file that's named FREAD.OUT and
// writes characters to the file. It then tries to open
// FREAD.OUT and read in characters by using fread_s. If the attempt succeeds,
// the program displays the number of actual items read.
 
#include <stdio.h>

#define BUFFERSIZE 30
#define DATASIZE 22
#define ELEMENTCOUNT 2
#define ELEMENTSIZE (DATASIZE/ELEMENTCOUNT)
#define FILENAME "FREAD.OUT"

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

   for ( i = 0; i < DATASIZE; i++ )
      list[i] = (char)('z' - i);
   list[DATASIZE] = '\0'; // terminal null so we can print it
      
   // Open file in text mode:
   if( fopen_s( &stream, FILENAME, "w+t" ) == 0 )
   {
      // Write DATASIZE characters to stream 
      printf( "Contents of buffer before write/read:\n\t%s\n\n", list );
      numwritten = fwrite( list, sizeof( char ), DATASIZE, stream );
      printf( "Wrote %d items\n\n", numwritten );
      fclose( stream );
   } else {
      printf( "Problem opening the file\n" );
      return -1;
   }

   if( fopen_s( &stream, FILENAME, "r+t" ) == 0 )   {
      // Attempt to read in characters in 2 blocks of 11
      numread = fread_s( list, BUFFERSIZE, ELEMENTSIZE, ELEMENTCOUNT, stream );
      printf( "Number of %d-byte elements read = %d\n\n", ELEMENTSIZE, numread );
      printf( "Contents of buffer after write/read:\n\t%s\n", list );
      fclose( stream );
   } else {
      printf( "File could not be opened\n" );
      return -1;
   }
}

Vedere anche

Riferimenti

Flusso I/O

fwrite

_read