fprintf_s, fwprintf_s

Aus RAD Studio
Wechseln zu: Navigation, Suche

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

+

+

+

Siehe auch