`fwrite`

Artikel
10/12/2023

Menulis data ke aliran.

Sintaks

size_t fwrite(
   const void *buffer,
   size_t size,
   size_t count,
   FILE *stream
);

Parameter

buffer
Arahkan ke data yang akan ditulis.

size
Ukuran item, dalam byte.

count
Jumlah maksimum item yang akan ditulis.

stream
Penunjuk ke FILE struktur.

Nilai hasil

fwrite mengembalikan jumlah item lengkap yang ditulis fungsi, yang mungkin kurang dari count jika terjadi kesalahan. Selain itu, jika terjadi kesalahan, indikator posisi file tidak dapat ditentukan. Jika atau streambuffer adalah penunjuk null, atau jika jumlah byte ganjil yang akan ditulis ditentukan dalam mode Unicode, fungsi memanggil handler parameter yang tidak valid, seperti yang dijelaskan dalam Validasi parameter. Jika eksekusi diizinkan untuk melanjutkan, fungsi ini diatur errno ke EINVAL dan mengembalikan 0.

Keterangan

Fungsi fwrite menulis hingga count item, masing-masing size panjang, dari buffer ke output stream. Penunjuk file yang terkait dengan stream (jika ada) bertambah dengan jumlah penulisan byte fwrite . Jika stream dibuka dalam mode teks, setiap umpan baris diganti dengan pasangan umpan kembali baris pengangkutan. Penggantian tidak berpengaruh pada nilai yang dikembalikan.

Ketika stream dibuka dalam mode terjemahan Unicode—misalnya, jika stream dibuka dengan memanggil fopen dan menggunakan parameter mode yang mencakup ccs=UNICODE, , ccs=UTF-16LEatau ccs=UTF-8, atau jika mode diubah ke mode terjemahan Unicode dengan menggunakan _setmode dan parameter mode yang menyertakan _O_WTEXT, , _O_U16TEXTatau _O_U8TEXT—buffer ditafsirkan sebagai penunjuk ke array wchar_t yang berisi data UTF-16. Upaya untuk menulis jumlah byte ganjil dalam mode ini menyebabkan kesalahan validasi parameter.

Karena fungsi ini mengunci utas panggilan, maka utas aman. Untuk versi non-penguncian, lihat _fwrite_nolock.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Persyaratan

Function	Header yang diperlukan
`fwrite`	`<stdio.h>`

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Lihat contoh untuk fread.

Bagikan melalui