fwrite
Bir akışa verileri yazar.
size_t fwrite( const void *buffer, size_t size, size_t count, FILE *stream );
Parametreler
buffer
Yazılacak veriler işaretçisi.size
Öğe, bayt boyutu.count
En fazla yazılacak öğe sayısı.stream
İşaretçi FILE yapısı.
Dönüş Değeri
fwritetam sayısını döndürür gerçekte yazılan öğeleri, hangi olabilir küçüktür count bir hata meydana gelirse.Ayrıca, bir hata meydana gelirse, dosya konumunu göstergesi belirlenemiyor.stream Veya buffer null bir işaretçidir veya tek bir yazılacak bayt sayısı Unicode modda belirtilirse, işlev geçersiz parametre işleyici açıklandığı gibi çağırır Parametre Doğrulama.Devam etmek için yürütme izin verilirse, bu işlev ayarlar errno için EINVAL ve 0 döndürür.
Notlar
fwrite İşlevi Yazar kadar count öğeleri, size uzunluğu her, gelen buffer çıktısına stream.İle ilişkili dosya işaretçisi stream (varsa) tarafından gerçekte yazılan bayt sayısı artırılır.Varsa stream açıldığında metin modunda, satır besleme her bir satır başı ile – satır besleme çifti değiştirilir.Değiştirme dönüş değeri üzerinde hiçbir etkisi yoktur.
Zaman stream Unicode çeviri modunda açılmış — Örneğin, varsa stream çağırarak açılan fopen ve içeren bir modu parametresini kullanarak ccs=UNICODE, ccs=UTF-16LE, veya ccs=UTF-8, veya modu kullanarak bir Unicode çeviri moduna değiştirilirse _setmode ve içeren bir mod parametresi _O_WTEXT, _O_U16TEXT, veya _O_U8TEXT—buffer bir dizi işaretçisi olarak yorumlanır wchar_t UTF-16 veri içeren.Bu modda tek sayıda bayt yazma girişimi bir parametre doğrulama hatasına neden olur.
Bu işlev çağıran iş parçacığı kilitler olduğundan, iş parçacığı güvenli gerekmez.Kilitleme olmayan bir sürümü için bkz: _fwrite_nolock.
Gereksinimler
İşlev |
Gerekli başlık |
|---|---|
fwrite |
< stdio.h > |
Uyumluluk ek bilgi için bkz Uyumluluk.
Örnek
Örneğin bakın fread.