CKTIS / C
fwrite — funzione di flusso C23
`fwrite(ptr, size, nmemb, stream)` di `<stdio.h>` scrive su uno stream fino a `nmemb` oggetti di `size` byte dall’array indicato da `ptr`. Ogni oggetto è trattato come chiamate successive a `fputc` sulla sua rappresentazione `unsigned char`; restituisce il numero di oggetti completi scritti.
Versione: C23
Sintassi
size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);fwrite(ptr, size, nmemb, stream) di <stdio.h> scrive su uno stream fino a nmemb oggetti di size byte dall’array indicato da ptr. Ogni oggetto è trattato come chiamate successive a fputc sulla sua rappresentazione unsigned char; restituisce il numero di oggetti completi scritti.
L’esempio scrive tre int con fwrite(values, sizeof values[0], 3, stream), che restituisce 3. Dopo il riavvolgimento li rilegge con lo stesso tipo e stampa 3 7 -2 42, mostrando che il conteggio è di elementi, non byte.
Un risultato minore di nmemb indica errore di scrittura; controlla anche ferror, perché byte dell’ultimo oggetto parziale possono essere già scritti. Se size o nmemb è zero, restituisce zero e lo stato dello stream non cambia. La sorgente deve coprire size * nmemb byte. Rappresentazioni grezze, padding, endian e larghezze dei tipi non formano un formato di scambio portabile.
Esempi
#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;}
Risultato
3 7 -2 42
L’esempio scrive tre `int` con `fwrite(values, sizeof values[0], 3, stream)`, che restituisce `3`. Dopo il riavvolgimento li rilegge con lo stesso tipo e stampa `3 7 -2 42`, mostrando che il conteggio è di elementi, non byte.