CKTIS / C
fwrite — função de fluxo C23
`fwrite(ptr, size, nmemb, stream)` de `<stdio.h>` escreve num fluxo até `nmemb` objetos de `size` bytes do array indicado por `ptr`. Cada objeto é processado como chamadas sucessivas a `fputc` sobre a representação `unsigned char`; devolve o número de objetos completos escritos.
Versão: C23
Sintaxe
size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fwrite(ptr, size, nmemb, stream) de <stdio.h> escreve num fluxo até nmemb objetos de size bytes do array indicado por ptr. Cada objeto é processado como chamadas sucessivas a fputc sobre a representação unsigned char; devolve o número de objetos completos escritos.
O exemplo escreve três int com fwrite(values, sizeof values[0], 3, stream), que devolve 3. Depois de voltar ao início, lê-os com o mesmo tipo e imprime 3 7 -2 42, mostrando que a contagem é de elementos e não de bytes.
Resultado inferior a nmemb significa erro de escrita; consulta também ferror, pois bytes do último objeto parcial podem já ter sido escritos. Se size ou nmemb for zero, devolve zero e o estado do fluxo não muda. A origem tem de cobrir size * nmemb bytes. Representações cruas podem conter padding e depender de endian e larguras dos tipos, portanto não são formato de intercâmbio portável.
Exemplos
#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;}
Resultado
3 7 -2 42
O exemplo escreve três `int` com `fwrite(values, sizeof values[0], 3, stream)`, que devolve `3`. Depois de voltar ao início, lê-os com o mesmo tipo e imprime `3 7 -2 42`, mostrando que a contagem é de elementos e não de bytes.