sprintf
, _sprintf_l
, swprintf
, _swprintf
, _swprintf_l
, __swprintf_l
Schreiben Sie formatierte Daten in eine Zeichenfolge. Sicherere Versionen einiger dieser Funktionen sind verfügbar; siehe sprintf_s
, , _sprintf_s_l
, . _swprintf_s_l
swprintf_s
Die sicheren Versionen und swprintf
_swprintf_l
nehmen die Größe des Puffers als Parameter.
Syntax
int sprintf(
char *buffer,
const char *format [,
argument] ...
);
int _sprintf_l(
char *buffer,
const char *format,
_locale_t locale [,
argument] ...
);
int swprintf(
wchar_t *buffer,
size_t count,
const wchar_t *format [,
argument]...
);
int _swprintf(
wchar_t *buffer,
const wchar_t *format [,
argument]...
);
int _swprintf_l(
wchar_t *buffer,
size_t count,
const wchar_t *format,
_locale_t locale [,
argument] ...
);
int __swprintf_l(
wchar_t *buffer,
const wchar_t *format,
_locale_t locale [,
argument] ...
);
template <size_t size>
int sprintf(
char (&buffer)[size],
const char *format [,
argument] ...
); // C++ only
template <size_t size>
int _sprintf_l(
char (&buffer)[size],
const char *format,
_locale_t locale [,
argument] ...
); // C++ only
Parameter
buffer
Speicherort für die Ausgabe
count
Maximale Anzahl, der in der Unicode-Version dieser Funktion zu speichernde Zeichen.
format
Formatsteuerzeichenfolge
argument
Optionale Argumente
locale
Das zu verwendende Gebietsschema.
Weitere Informationen finden Sie unter Formatspezifikationssyntax.
Rückgabewert
Die Anzahl der geschriebenen Zeichen oder -1, wenn ein Fehler aufgetreten ist. Wenn buffer
es sich um format
einen Nullzeiger handelt, wird der ungültige Parameterhandler aufgerufen, wie in der Parameterüberprüfung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen "– 1" zurück und legen errno
auf EINVAL
fest.
sprintf
gibt die in buffer
gespeicherte Byteanzahl zurück. Das beendende NULL-Zeichen wird dabei nicht mitgezählt. swprintf
gibt die Anzahl der in buffer
gespeicherten Breitzeichen zurück. Das beendende NULL-Breitzeichen wird dabei nicht mitgezählt.
Hinweise
Die sprintf
-Funktion formatiert und speichert eine Reihe von Zeichen und Werte in buffer
. Jedes argument
(falls vorhanden) wird entsprechend der jeweiligen Formatangabe in format
konvertiert und ausgegeben. Das Format besteht aus normalen Zeichen und hat die gleiche Form und Funktion wie das format
-Argument für printf
. Ein NULL-Zeichen wird nach dem letzten geschriebenen Zeichen angefügt. Wenn der Kopiervorgang zwischen Zeichenfolgen ausgeführt wird, die sich überschneiden, ist das Verhalten nicht definiert.
Wichtig
Bei der Verwendung von sprintf
gibt es keine Möglichkeit, die Anzahl der geschriebenen Zeichen einzuschränken. Demnach ist Code mit sprintf
für Pufferüberläufe anfällig. Erwägen Sie die Verwendung der verwandten Funktion _snprintf
, die eine maximale Anzahl von Zeichen angibt, in buffer
die geschrieben werden soll, oder verwenden Sie die Verwendung _scprintf
, um zu bestimmen, wie groß ein Puffer erforderlich ist. Stellen Sie zudem sicher, dass format
keine benutzerdefinierte Zeichenfolge ist.
Ab Windows 10, Version 2004 (Build 19041), druckt die printf
Funktionsfamilie exakt repräsentierbare Gleitkommazahlen gemäß den IEEE 754-Regeln zum Runden. In früheren Versionen von Windows würden exakt dargestellte Gleitkommazahlen, die auf "5" enden, immer aufgerundet. IEEE 754 gibt an, dass sie auf die nächstgelegene gerade Ziffer runden müssen (auch bekannt als "Banker es Rounding"). Beispielsweise sollten beide printf("%1.0f", 1.5)
auf printf("%1.0f", 2.5)
2 gerundet werden. Zuvor würde 1,5 auf 2 und 2,5 runden auf 3. Diese Änderung wirkt sich nur auf genau darstellbare Zahlen aus. Beispielsweise wird 2.35 (die, wenn sie im Arbeitsspeicher dargestellt wird, näher an 2.35000000000000008) weiter auf 2,4 aufgerundet. Das Runden dieser Funktionen berücksichtigt nun auch den gleitkommafreien Rundungsmodus, der von fesetround
. Zuvor wählte das Rundungsverhalten immer aus FE_TONEAREST
. Diese Änderung betrifft nur Programme, die mit Visual Studio 2019, Version 16.2 und höher erstellt wurden. Wenn Sie das ältere Gleitkomma-Rundungsverhalten verwenden möchten, verknüpfen Sie die Verknüpfung mit "legacy_stdio_float_rounding.obj".
swprintf
ist eine Breitzeichen-Version von sprintf
. Die Zeigerargumente zu swprintf
sind Breitzeichen-Zeichenfolgen. Die Erkennung von Codierungsfehlern in swprintf
kann sich von sprintf
. swprintf
und fwprintf
verhalten sich identisch, mit Ausnahme swprintf
von Schreibvorgängen in eine Zeichenfolge und nicht auf ein Ziel des Typs FILE
, und swprintf
der Parameter muss count
die maximale Anzahl von Zeichen angeben, die geschrieben werden sollen. Die Versionen dieser Funktionen mit dem _l
Suffix sind identisch, außer dass sie den gebietsschemaparameter verwenden, der anstelle des aktuellen Threadgebietsschemas übergeben wird.
Bevor die Signatur swprintf
standardisiert wurde, wurde eine Version in einer älteren Microsoft C-Laufzeitbibliothek ausgeliefert, die den Parameter für die Zeichenanzahl nicht verwendet hat. Die ältere Version ist weiterhin in der Microsoft C-Laufzeitbibliothek verfügbar, ist jedoch veraltet und wurde umbenannt _swprintf()
. Definieren Sie für Code, der mit der älteren Signatur geschrieben wurde, _CRT_NON_CONFORMING_SWPRINTFS
die Aufrufe zu _swprintf
swprintf
. In einer zukünftigen Version wird das alte Verhalten möglicherweise entfernt. Daher sollte Code so geändert werden, dass das neue konforme Verhalten verwendet wird.
In C++ haben diese Funktionen Vorlagenüberladungen, mit denen die neueren, sicheren Entsprechungen dieser Funktionen aufgerufen werden. Weitere Informationen finden Sie unter "Sichere Vorlagenüberladungen".
Generische Textroutinzuordnungen
TCHAR.H Routine |
_UNICODE und _MBCS nicht definiert |
_MBCS Definiert |
_UNICODE Definiert |
---|---|---|---|
_stprintf |
sprintf |
sprintf |
_swprintf |
_stprintf_l |
_sprintf_l |
_sprintf_l |
__swprintf_l |
Anforderungen
Routine | Erforderlicher Header |
---|---|
sprintf , _sprintf_l |
<stdio.h> |
swprintf , _swprintf , _swprintf_l |
<stdio.h> oder <wchar.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel: Verwenden sprintf
zum Formatieren von Daten
// crt_sprintf.c
// compile with: /W3
// This program uses sprintf to format various
// data and place them in the string named buffer.
#include <stdio.h>
int main( void )
{
char buffer[200], s[] = "computer", c = 'l';
int i = 35, j;
float fp = 1.7320534f;
// Format and print various data:
j = sprintf( buffer, " String: %s\n", s ); // C4996
j += sprintf( buffer + j, " Character: %c\n", c ); // C4996
j += sprintf( buffer + j, " Integer: %d\n", i ); // C4996
j += sprintf( buffer + j, " Real: %f\n", fp );// C4996
// Note: sprintf is deprecated; consider using sprintf_s instead
printf( "Output:\n%s\ncharacter count = %d\n", buffer, j );
}
Output:
String: computer
Character: l
Integer: 35
Real: 1.732053
character count = 79
Beispiel: Fehlercodebehandlung
// crt_swprintf.c
// wide character example
// also demonstrates swprintf returning error code
#include <stdio.h>
int main( void )
{
wchar_t buf[100];
int len = swprintf( buf, 100, L"%s", L"Hello world" );
printf( "wrote %d characters\n", len );
len = swprintf( buf, 100, L"%s", L"Hello\xffff world" );
// swprintf fails because string contains WEOF (\xffff)
printf( "wrote %d characters\n", len );
}
wrote 11 characters
wrote -1 characters
Siehe auch
Stream-E/A
fprintf
, _fprintf_l
, fwprintf
, _fwprintf_l
printf
, _printf_l
, wprintf
, _wprintf_l
scanf
, _scanf_l
, wscanf
, _wscanf_l
sscanf
, _sscanf_l
, swscanf
, _swscanf_l
vprintf
-Funktionen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für