sprintf, , _sprintf_lswprintf, _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_lswprintf_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 Formatspezifikations-Syntax.

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 EINVALfest.

sprintf gibt die in buffergespeicherte 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 formatkonvertiert 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 bufferdie 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) gibt die printf-Funktionsfamilie exakt darstellbare Fließkommazahlen gemäß den IEEE 754-Rundungsregeln aus. In früheren Versionen von Windows wurden exakt darstellbare Fließkommazahlen, die auf „5“ endeten, immer aufgerundet. IEEE 754 besagt, dass sie auf die nächste gerade Ziffer gerundet werden müssen (auch bekannt als „Unverzerrte Rundung“). Beispielsweise sollten sowohl printf("%1.0f", 1.5) als auch printf("%1.0f", 2.5) auf 2 gerundet werden. Zuvor wurde 1,5 auf 2 und 2,5 auf 3 gerundet. Diese Änderung wirkt sich nur auf genau darstellbare Zahlen aus. 2,35 (was bei der Darstellung im Speicher näher an 2,35000000000000008 liegt) rundet zum Beispiel weiterhin auf 2,4 auf. Die Rundung durch diese Funktionen berücksichtigt nun auch den Fließkomma-Rundungsmodus, der durch fesetroundfestgelegt wird. Zuvor wählte die Rundung immer das FE_TONEAREST-Verhalten. Diese Änderung betrifft nur Programme, die mit Visual Studio 2019, Version 16.2 und höher erstellt wurden. Um das alte Fließkomma-Rundungsverhalten zu verwenden, verknüpfen Sie 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_SWPRINTFSdie Aufrufe zu _swprintfswprintf . 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 Secure Template Overloads.

Mapping generischer Textroutinen

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

Weitere Informationen

Stream-E/A
fprintf, , _fprintf_lfwprintf_fwprintf_l
printf, , _printf_lwprintf_wprintf_l
scanf, , _scanf_lwscanf_wscanf_l
sscanf, , _sscanf_lswscanf_swscanf_l
vprintf-Funktionen