fprintf_s, fwprintf_s
Nach oben zu stdio.h - Index
Header-Datei
stdio.h
Kategorie
Funktionen für die formatierte Eingabe/Ausgabe
Prototyp
int fprintf_s(FILE * restrict stream, const char * restrict format, [,argument, ...]);
int fwprintf_s(FILE * restrict stream, const wchar_t * restrict format, [,argument, ...]);
Beschreibung
Ersetzt fprintf, fwprintf und fügt Sicherheitserweiterungen hinzu.
fprintf_s akzeptiert eine Reihe von Argumenten für Formatbezeichner, die in dem Format-String enthalten sind, auf den format zeigt. Die formatierten Daten werden in stream ausgegeben. Die Anzahl der Formatbezeichner muss gleich der Anzahl der Argumente sein.
Hinweis: Einzelheiten zu Formatbezeichnern finden Sie unter Formatbezeichner in C/C++.
Zusätzlich zu fprintf verfügt fprintf_s über Laufzeiteinschränkungen, für den Fall, dass der %n-Bezeichner nicht in format enthalten ist. Des Weiteren darf das zu einem %s-Bezeichner gehörende Argument in der arguments-Liste kein Null-Zeiger sein.
Bei einem Fehler bricht fprintf_s die Ausgabe ab.
Rückgabewert
fprintf_s gibt die Anzahl der übertragenen Zeichen zurück. Bei einem Fehler wird ein negativer Wert zurückgegeben.
Beispiel
#include <stdio.h> int main(void) { FILE *stream; int i = 100; char c = 'C'; float f = 1.234; /* Open a file for update */ if(fopen_s(&stream,"DUMMY.FIL", "w+")){ printf("Unable to create DUMMY.FIL"); } else{ /* Write some data to the file */ fprintf_s(stream, "%d %c %f", i, c, f); } /* Close the file */ fclose(stream); return 0; }
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
fprintf_s |
+ |
+ |
+ |
+ |
fwprintf_s |
+ |
+ |
+ |