fwrite
Scrive i dati in un flusso.
size_t fwrite( const void *buffer, size_t size, size_t count, FILE *stream );
Parametri
buffer
Puntatore ai dati da scrivere.size
Dimensioni elemento, in byte.count
Numero massimo di elementi da scrivere.stream
Puntatore alla struttura FILE.
Valore restituito
fwrite restituisce il numero degli elementi completi attualmente scritti, che può risultare inferiore a count se si verifica un errore. Inoltre, se si verifica un errore, non è possibile determinare l'indicatore della posizione del file. Se stream o buffer è un puntatore Null o se un numero dispari di byte da scrivere è specificato in modalità Unicode, la funzione richiama il gestore di parametro non valido, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, la funzione imposta errno suEINVAL e restituisce 0.
Note
La funzione fwrite scrive fino a count elementi, ognuno con una lunghezza pari a size, da buffer in stream di output. Il puntatore del file associato a stream (se presente) viene incrementato del numero di byte effettivamente scritti. Se stream viene aperto in modalità testo,ogni carattere di avanzamento riga è sostituito da una coppia di segni di avanzamento riga con avanzamento riga. La sostituzione non ha effetto sul valore restituito.
Quando stream viene aperto nella modalità di conversione Unicode, ad esempio se stream viene aperto tramite una chiamata a fopen e l'uso di un parametro modalità che include ccs=UNICODE, ccs=UTF-16LE o ccs=UTF-8, o se la modalità viene sostituita da una modalità di conversione Unicode tramite _setmode e un parametro modalità che include _O_WTEXT, _O_U16TEXT o _O_U8TEXT, buffer viene interpretato come un puntatore a una matrice di wchar_t che contiene dati UTF-16. Un tentativo di scrivere un numero dispari di byte in questa modalità causerà un errore di convalida del parametro.
Poiché questa funzione blocca il thread di chiamata, può essere considerata thread-safe. Per una versione che non blocca il thread, vedere _fwrite_nolock.
Requisiti
Funzione |
Intestazione obbligatoria |
---|---|
fwrite |
<stdio.h> |
Per altre informazioni sulla compatibilità, vedere Compatibilità.
Esempio
Vedere l'esempio relativo a fread.