fwrite
Zapisuje data do datového proudu.
size_t fwrite( const void *buffer, size_t size, size_t count, FILE *stream );
Parametry
buffer
Ukazatel na data, která mají být zapsána.size
Položka velikost v bajtech.count
Maximální počet položek, které má být proveden zápis.stream
Ukazatel na FILE struktury.
Vrácená hodnota
fwriteVrátí počet plně skutečně zapsána položek, které mohou být menší než count Pokud dojde k chybě.Také pokud dojde k chybě, nelze určit indikátoru pozice v souboru.Pokud buď stream nebo buffer je ukazatel s hodnotou null, nebo pokud lichý počet bajtů, které mají být zapsána je zadán v režimu Unicode, funkce vyvolá obslužnou rutinu neplatný parametr, jak je popsáno v Ověření parametru.Pokud je povoleno spuštění chcete-li pokračovat, tato funkce nastaví errno k EINVAL a vrátí hodnotu 0.
Poznámky
fwrite Funkce zapíše až count položek, z size délka jednotlivých, z buffer do výstupu stream.Ukazatel na soubor přidružený k stream (pokud existuje) se zvýší počtem skutečně zapsaných bajtů.Pokud stream je otevřen v režimu textových každý konce řádku je nahrazen návrat – dvojice konce řádku.Náhrada nemá žádný vliv na návratovou hodnotu.
Při stream je otevřen v režimu překladu Unicode – například pokud stream je otevřený voláním fopen a použití režimu parametr, který zahrnuje ccs=UNICODE, ccs=UTF-16LE, nebo ccs=UTF-8, nebo je-li režim se změní na režim překladu Unicode pomocí _setmode a režimu parametr, který zahrnuje _O_WTEXT, _O_U16TEXT, nebo _O_U8TEXT–buffer interpretována jako ukazatel na pole wchar_t obsahující data UTF-16.Pokus o zápis lichý počet bajtů v tomto režimu způsobí, že chyba ověření parametru.
Tato funkce zamkne volající vlákno, proto je vláken.Bez uzamčení verzi, najdete v _fwrite_nolock.
Požadavky
Funkce |
Požadovaný hlavičkový soubor |
|---|---|
fwrite |
< stdio.h > |
Další informace o kompatibilitě, naleznete v části kompatibility.
Příklad
Podívejte se na příklad pro fread.