fwrite
Schreibt Daten in einen Stream.
size_t fwrite( const void *buffer, size_t size, size_t count, FILE *stream );
Parameter
buffer
Zeiger auf die zu schreibenden Daten.size
Elementgröße in Bytes.count
Maximale Anzahl zu schreibender Elemente.stream
Zeiger zur FILE-Struktur.
Rückgabewert
fwrite gibt die Anzahl der tatsächlich geschriebenen vollständigen Elemente zurück. Diese kann kleiner sein als count, wenn ein Fehler auftritt. Außerdem kann im Fall eines Fehlers möglicherweise der Dateipositionszeiger nicht bestimmt werden. Wenn entweder stream oder buffer ein NULL-Zeiger ist oder wenn im Unicode-Modus eine ungerade Anzahl zu schreibender Bytes festgelegt wird, ruft diese Funktion den Handler für ungültige Parameter auf, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, setzt diese Funktion errno auf EINVAL und gibt "0" zurück.
Hinweise
Die fwrite-Funktion schreibt bis zu count Elemente, alle mit einer Länge von size, aus dem Puffer buffer in den Ausgabe-stream. Der mit stream assoziierte Dateizeiger (falls vorhanden) wird um die Anzahl tatsächlich geschriebener Bytes erhöht. Wenn stream im Textmodus geöffnet wird, wird jeder Zeilenvorschub durch einen Zeilenvorschub plus ein Wagenrücklaufzeichen ersetzt. Diese Ersetzung hat keine Auswirkung auf den Rückgabewert.
Wenn stream in einem Unicode-Übersetzungsmodus geöffnet wird – z. B., wenn stream durch Aufrufen von fopen geöffnet wird und ein Modusparameter verwendet wird, der ccs=UNICODE, ccs=UTF-16LE oder ccs=UTF-8 enthält, oder wenn der Modus durch Verwendung von _setmode und einem Modusparameter, der _O_WTEXT, _O_U16TEXT oder _O_U8TEXT enthält, in einen Unicode-Übersetzungsmodus geändert wird –, dann wird buffer als Zeiger auf ein Array von wchar_t interpretiert, das UTF-16 -Daten enthält. Der Versuch, in diesem Modus eine ungerade Anzahl von Bytes zu schreiben, führt zu einem Parametervalidierungsfehler.
Da diese Funktion den aufrufenden Thread sperrt, ist sie threadsicher. Eine nicht sperrende Version finden Sie unter _fwrite_nolock.
Anforderungen
Funktion |
Erforderlicher Header |
|---|---|
fwrite |
<stdio.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
Betrachten Sie das Beispiel für fread.