Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

fread — funkcja strumieniowa C23

`fread(ptr, size, nmemb, stream)` z `<stdio.h>` próbuje odczytać `nmemb` elementów po `size` bajtów do tablicy `ptr` i zwraca liczbę całkowicie odczytanych elementów. Dane są traktowane jak ciąg `unsigned char`; krótszy wynik oznacza EOF albo błąd.

Wersja: C23

Składnia

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

fread(ptr, size, nmemb, stream) z <stdio.h> próbuje odczytać nmemb elementów po size bajtów do tablicy ptr i zwraca liczbę całkowicie odczytanych elementów. Dane są traktowane jak ciąg unsigned char; krótszy wynik oznacza EOF albo błąd.

Przykład zapisuje pięć bajtów ABCDE, a następnie dwukrotnie żąda po trzy bajty. Wynik 3 2 1 ABC DE pokazuje pełny pierwszy odczyt, dwa dostępne bajty drugiego odczytu oraz ustawiony wskaźnik EOF.

Bufor musi pomieścić size * nmemb; oblicz pojemność bez przepełnienia. Przy size == 0 lub nmemb == 0 funkcja zwraca zero bez zmiany tablicy i stanu strumienia. Po krótkim wyniku użyj feof i ferror; wykorzystuj tylko kompletne elementy, ponieważ niepełny element nie zwiększa zwracanej liczby.

Przykłady

#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;}

Wynik

3 2 1 ABC DE

Przykład zapisuje pięć bajtów `ABCDE`, a następnie dwukrotnie żąda po trzy bajty. Wynik `3 2 1 ABC DE` pokazuje pełny pierwszy odczyt, dwa dostępne bajty drugiego odczytu oraz ustawiony wskaźnik EOF.

Źródła