fwrite
Schreibt Daten in einen Stream.
Syntax
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 vollständigen Elemente zurück, die die Funktion schreibt, was kleiner sein kann als count
wenn ein Fehler auftritt. Wenn ein Fehler auftritt, kann der Dateipositionsindikator nicht bestimmt werden. Wenn es sich um stream
einen Nullzeiger handelt oder buffer
eine ungerade Anzahl von Bytes, die geschrieben werden sollen, im Unicode-Modus angegeben ist, ruft die Funktion den ungültigen Parameterhandler auf, wie in der Parameterüberprüfung 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 Dateizeiger, der (falls vorhanden) zugeordnet stream
ist, wird um die Anzahl der Byte-Schreibvorgänge fwrite
erhöht. Wenn stream
im Textmodus geöffnet wird, wird jeder Zeilenvorschub durch ein Wagenrücklauf-Zeilenvorschubpaar 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
.
Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Wie Sie dieses Verhalten ändern, erfahren Sie unter Globaler Status in der CRT.
Anforderungen
Funktion | Erforderlicher Header |
---|---|
fwrite |
<stdio.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel
Ein Beispiel hierfür finden Sie unter fread
.
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für