CKTIS / C
fread — fonction de flux C23
`fread(ptr, size, nmemb, stream)` de `<stdio.h>` tente de lire `nmemb` éléments de `size` octets dans `ptr` et renvoie le nombre d’éléments complets. Les données sont une suite d’`unsigned char` ; un compte court signifie fin ou erreur.
Version : C23
Syntaxe
size_t fread(void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fread(ptr, size, nmemb, stream) de <stdio.h> tente de lire nmemb éléments de size octets dans ptr et renvoie le nombre d’éléments complets. Les données sont une suite d’unsigned char ; un compte court signifie fin ou erreur.
L’exemple stocke cinq octets ABCDE, puis en demande deux fois trois. 3 2 1 ABC DE montre une première lecture complète, deux octets disponibles à la seconde et l’indicateur de fin posé.
La destination doit contenir size * nmemb sans débordement du calcul. Si size == 0 ou nmemb == 0, retour zéro sans modifier tableau ou flux. Après un compte court, testez feof et ferror ; n’utilisez que les éléments complets, car un élément partiel n’est pas compté.
Exemples
#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;}
Résultat
3 2 1 ABC DE
L’exemple stocke cinq octets `ABCDE`, puis en demande deux fois trois. `3 2 1 ABC DE` montre une première lecture complète, deux octets disponibles à la seconde et l’indicateur de fin posé.