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.