Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

fwrite — proudová funkce C23

`fwrite(ptr, size, nmemb, stream)` z `<stdio.h>` zapíše do proudu až `nmemb` objektů po `size` bajtech z pole označeného `ptr`. Každý objekt se zpracuje jako následná volání `fputc` nad jeho reprezentací `unsigned char`; návratová hodnota počítá celé zapsané objekty.

Verze: C23

Syntaxe

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

fwrite(ptr, size, nmemb, stream) z <stdio.h> zapíše do proudu až nmemb objektů po size bajtech z pole označeného ptr. Každý objekt se zpracuje jako následná volání fputc nad jeho reprezentací unsigned char; návratová hodnota počítá celé zapsané objekty.

Příklad zapíše tři hodnoty int pomocí fwrite(values, sizeof values[0], 3, stream), které vrátí 3. Po návratu na začátek je načte stejným typem a vytiskne 3 7 -2 42; počet je v prvcích, nikoli bajtech.

Výsledek menší než nmemb znamená chybu zápisu; zkontrolujte i ferror, protože bajty částečného posledního objektu již mohou být zapsány. Je-li size či nmemb nula, vrátí nulu a stav proudu se nezmění. Zdroj musí pokrývat size * nmemb bajtů. Surová reprezentace může mít padding a záviset na endianitě i šířkách typů, takže není přenositelným formátem.

Příklady

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

Výsledek

3 7 -2 42

Příklad zapíše tři hodnoty `int` pomocí `fwrite(values, sizeof values[0], 3, stream)`, které vrátí `3`. Po návratu na začátek je načte stejným typem a vytiskne `3 7 -2 42`; počet je v prvcích, nikoli bajtech.

Zdroje