CKTIS / C
fread — función de flujo de C23
`fread(ptr, size, nmemb, stream)` de `<stdio.h>` intenta leer `nmemb` elementos de `size` bytes en `ptr` y devuelve el número de elementos completos. Los datos son una secuencia de `unsigned char`; un recuento corto significa fin o error.
Versión: C23
Sintaxis
size_t fread(void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fread(ptr, size, nmemb, stream) de <stdio.h> intenta leer nmemb elementos de size bytes en ptr y devuelve el número de elementos completos. Los datos son una secuencia de unsigned char; un recuento corto significa fin o error.
El ejemplo guarda cinco bytes ABCDE y pide dos veces tres. 3 2 1 ABC DE muestra primera lectura completa, dos bytes disponibles en la segunda e indicador de fin fijado.
El destino debe alojar size * nmemb; calcula la capacidad sin desbordar. Si size == 0 o nmemb == 0, devuelve cero sin cambiar array ni flujo. Tras un recuento corto usa feof y ferror; usa solo elementos completos, pues uno parcial no incrementa el resultado.
Ejemplos
#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;}
Resultado
3 2 1 ABC DE
El ejemplo guarda cinco bytes `ABCDE` y pide dos veces tres. `3 2 1 ABC DE` muestra primera lectura completa, dos bytes disponibles en la segunda e indicador de fin fijado.