CKTIS / C
fread — funzione di flusso C23
`fread(ptr, size, nmemb, stream)` di `<stdio.h>` tenta di leggere `nmemb` elementi di `size` byte in `ptr` e restituisce quanti sono completi. I dati sono una sequenza di `unsigned char`; un conteggio breve significa fine o errore.
Versione: C23
Sintassi
size_t fread(void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fread(ptr, size, nmemb, stream) di <stdio.h> tenta di leggere nmemb elementi di size byte in ptr e restituisce quanti sono completi. I dati sono una sequenza di unsigned char; un conteggio breve significa fine o errore.
L’esempio salva cinque byte ABCDE e richiede due volte tre. 3 2 1 ABC DE mostra prima lettura completa, due byte nella seconda e indicatore di fine impostato.
La destinazione deve contenere size * nmemb; calcola senza overflow. Se size == 0 o nmemb == 0, ritorna zero senza cambiare array o stream. Dopo un conteggio breve usa feof e ferror; usa solo elementi completi perché uno parziale non viene contato.
Esempi
#include <stdio.h>
int main(void){FILE*s=tmpfile();if(!s)return 1;if(fwrite("ABCDE",1,5,s)!=5){fclose(s);return 1;}rewind(s);char a[4]={0},b[4]={0};size_t n1=fread(a,1,3,s),n2=fread(b,1,3,s);printf("%zu %zu %d %s %s\n",n1,n2,feof(s)!=0,a,b);return fclose(s)==0?0:1;}
Risultato
3 2 1 ABC DE
L’esempio salva cinque byte `ABCDE` e richiede due volte tre. `3 2 1 ABC DE` mostra prima lettura completa, due byte nella seconda e indicatore di fine impostato.