Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

fwrite — funkcja strumieniowa C23

`fwrite(ptr, size, nmemb, stream)` z `<stdio.h>` zapisuje do strumienia do `nmemb` obiektów po `size` bajtów z tablicy wskazanej przez `ptr`. Każdy obiekt jest przetwarzany jak kolejne wywołania `fputc` dla jego reprezentacji jako `unsigned char`; funkcja zwraca liczbę całkowicie zapisanych obiektów.

Wersja: C23

Składnia

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

fwrite(ptr, size, nmemb, stream) z <stdio.h> zapisuje do strumienia do nmemb obiektów po size bajtów z tablicy wskazanej przez ptr. Każdy obiekt jest przetwarzany jak kolejne wywołania fputc dla jego reprezentacji jako unsigned char; funkcja zwraca liczbę całkowicie zapisanych obiektów.

Przykład zapisuje trzy wartości int przez fwrite(values, sizeof values[0], 3, stream), co zwraca 3. Po przewinięciu odczytuje je z powrotem tym samym typem i wypisuje 3 7 -2 42, pokazując licznik elementów, nie bajtów.

Wynik mniejszy niż nmemb oznacza błąd zapisu; sprawdź też ferror, bo częściowe bajty ostatniego obiektu mogą już trafić do pliku. Gdy size albo nmemb jest zerem, wynik wynosi zero, a stan strumienia pozostaje bez zmian. Bufor musi obejmować size * nmemb bajtów. Surowe reprezentacje obiektów mogą zawierać padding oraz zależeć od endianowości i rozmiarów typów, więc nie są przenośnym formatem wymiany.

Przykłady

#include <stdio.h>
int main(void){int values[3]={7,-2,42},copy[3]={0};FILE *stream=tmpfile();if(!stream)return 1;size_t written=fwrite(values,sizeof values[0],3,stream);rewind(stream);if(fread(copy,sizeof copy[0],3,stream)!=3){fclose(stream);return 1;}printf("%zu %d %d %d\n",written,copy[0],copy[1],copy[2]);return fclose(stream)==0?0:1;}

Wynik

3 7 -2 42

Przykład zapisuje trzy wartości `int` przez `fwrite(values, sizeof values[0], 3, stream)`, co zwraca `3`. Po przewinięciu odczytuje je z powrotem tym samym typem i wypisuje `3 7 -2 42`, pokazując licznik elementów, nie bajtów.

Źródła