Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

fread — função de fluxo C23

`fread(ptr, size, nmemb, stream)` de `<stdio.h>` tenta ler `nmemb` elementos de `size` bytes para `ptr` e devolve quantos ficaram completos. Os dados são sequência de `unsigned char`; contagem curta significa fim ou erro.

Versão: C23

Sintaxe

size_t fread(void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);

fread(ptr, size, nmemb, stream) de <stdio.h> tenta ler nmemb elementos de size bytes para ptr e devolve quantos ficaram completos. Os dados são sequência de unsigned char; contagem curta significa fim ou erro.

O exemplo guarda cinco bytes ABCDE e pede duas vezes três. 3 2 1 ABC DE mostra primeira leitura completa, dois bytes na segunda e indicador de fim definido.

O destino tem de conter size * nmemb; calcula sem overflow. Se size == 0 ou nmemb == 0, devolve zero sem alterar array ou fluxo. Após contagem curta usa feof e ferror; usa só elementos completos porque um parcial não é contado.

Exemplos

#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

O exemplo guarda cinco bytes `ABCDE` e pede duas vezes três. `3 2 1 ABC DE` mostra primeira leitura completa, dois bytes na segunda e indicador de fim definido.

Fontes