fread_s
Legge i dati da un flusso. Questa versione di include miglioramenti per fread la sicurezza, come descritto in Funzionalità di sicurezza in CRT.
Sintassi
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
Dimensioni del buffer di destinazione in byte.
elementSize
Dimensione dell'elemento da leggere in byte.
count
Numero massimo di elementi da leggere.
stream
Puntatore alla struttura FILE .
Valore restituito
fread_s restituisce il numero di elementi (interi) letti nel buffer, che può essere minore di count se viene rilevato un errore di lettura o la fine del file prima di raggiungere count. Usa la funzione feof o ferror per distinguere una condizione di errore da una condizione di fine del file. Se size o count è 0, fread_s restituisce 0 e il contenuto del buffer rimane invariato. Se stream o buffer è un puntatore Null, fread_s richiama il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione imposta errno suEINVAL e restituisce 0.
Per altre informazioni sui codici di errore, vedere errno, _doserrno, _sys_errliste _sys_nerr.
Osservazioni:
La funzione fread_s legge fino a count elementi con dimensioni in byte pari a elementSize dall'elemento stream di output e li archivia in buffer. Il puntatore al file associato ( stream se presente) è avanzato dal numero di byte fread_s letti. Se il flusso specificato viene aperto in modalità testo, le coppie di avanzamento ritorno a capo vengono sostituite con singoli caratteri di avanzamento riga. La sostituzione non ha effetto sul puntatore del file o sul valore restituito. La posizione del puntatore del file è indeterminata se si verifica un errore. Non è possibile determinare il valore di un elemento parzialmente letto.
Questa funzione blocca gli altri thread. Se è necessaria una versione che non blocca il thread, usare _fread_nolock.
Per impostazione predefinita, lo stato globale di questa funzione è limitato all'applicazione. Per modificare questo comportamento, vedere Stato globale in CRT.
Requisiti
| Funzione | Intestazione obbligatoria |
|---|---|
fread_s |
<stdio.h> |
Per altre informazioni sulla compatibilità, vedere Compatibility (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;
}
}
Contents of buffer before write/read:
zyxwvutsrqponmlkjihgfe
Wrote 22 items
Number of 11-byte elements read = 2
Contents of buffer after write/read:
zyxwvutsrqponmlkjihgfe