_sprintf_p
, _sprintf_p_l
, _swprintf_p
, _swprintf_p_l
Schreiben Sie formatierte Daten in eine Zeichenfolge mit der Möglichkeit, die Reihenfolge anzugeben, in der die Parameter in der Formatzeichenfolge verwendet werden.
Syntax
int _sprintf_p(
char *buffer,
size_t sizeOfBuffer,
const char *format [,
argument_list]
);
int _sprintf_p_l(
char *buffer,
size_t sizeOfBuffer,
const char *format,
_locale_t locale [,
argument_list]
);
int _swprintf_p(
wchar_t *buffer,
size_t sizeOfBuffer,
const wchar_t *format [,
argument_list]
);
int _swprintf_p_l(
wchar_t *buffer,
size_t sizeOfBuffer,
const wchar_t *format,
_locale_t locale [,
argument_list]
);
Parameter
buffer
Speicherort für die Ausgabe
sizeOfBuffer
Die maximale Anzahl der zu speichernden Zeichen.
format
Formatsteuerzeichenfolge.
argument_list
Optionale Argumente für die Formatzeichenfolge.
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.
Hinweise
Die _sprintf_p
-Funktion formatiert und speichert eine Reihe von Zeichen und Werte in buffer
. Jedes Argument in der argument_list
(falls vorhanden) wird konvertiert und gemäß der entsprechenden Formatspezifikation ausgegeben in format
. Das format
Argument verwendet die Formatspezifikationssyntax für printf
und wprintf
Funktionen. 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. Der Unterschied zwischen _sprintf_p
und sprintf_s
ist, dass _sprintf_p
Positionsparameter unterstützt, wodurch festgelegt werden kann, in welcher Reihenfolge die Argumente in der Formatzeichenfolge verwendet werden. Weitere Informationen finden Sie unter printf_p
Positionsparameter.
_swprintf_p
ist eine Breitzeichen-Version von _sprintf_p
. Die Zeigerargumente zu _swprintf_p
sind Breitzeichen-Zeichenfolgen. Die Erkennung von Codierungsfehlern in _swprintf_p
kann sich von der Erkennung unterscheiden in _sprintf_p
. _swprintf_p
und fwprintf_p
verhalten sich identisch, außer dass die Ausgabe von _swprintf_p
in eine Zeichenfolge anstatt an ein Ziel des FILE
-Typs schreibt, und dass _swprintf_p
den count
-Parameter zur Angabe der maximale Anzahl zu schreibender Zeichen erfordert. Die Versionen dieser Funktionen mit dem _l
-Suffix sind beinahe identisch, verwenden jedoch den ihnen übergebenen Gebietsschemaparameter anstelle des aktuellen Threadgebietsschemas.
_sprintf_p
gibt die in buffer
gespeicherte Byteanzahl zurück. Das beendende NULL-Zeichen wird dabei nicht mitgezählt. _swprintf_p
gibt die Anzahl der in buffer
gespeicherten Breitzeichen zurück. Das beendende NULL-Breitzeichen wird dabei nicht mitgezählt. Wenn buffer
es sich um einen Nullzeiger handelt oder format
wenn die Formatzeichenfolge ungültige Formatierungszeichen enthält, 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.
Wichtig
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".
Generische Textroutinzuordnungen
TCHAR.H Routine |
_UNICODE und _MBCS nicht definiert |
_MBCS Definiert |
_UNICODE Definiert |
---|---|---|---|
_stprintf_p |
_sprintf_p |
_sprintf_p |
_swprintf_p |
_stprintf_p_l |
_sprintf_p_l |
_sprintf_p_l |
_swprintf_p_l |
Anforderungen
Routine | Erforderlicher Header |
---|---|
_sprintf_p , _sprintf_p_l |
<stdio.h> |
_swprintf_p , _swprintf_p_l |
<stdio.h> oder <wchar.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.
Beispiel: Verwenden _sprintf_p
zum Formatieren von Daten
// crt_sprintf_p.c
// This program uses _sprintf_p 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_p( buffer, 200,
" String: %s\n", s );
j += _sprintf_p( buffer + j, 200 - j,
" Character: %c\n", c );
j += _sprintf_p( buffer + j, 200 - j,
" Integer: %d\n", i );
j += _sprintf_p( buffer + j, 200 - j,
" Real: %f\n", fp );
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_p.c
// This is the wide character example which
// also demonstrates _swprintf_p returning
// error code.
#include <stdio.h>
#define BUFFER_SIZE 100
int main( void )
{
wchar_t buffer[BUFFER_SIZE];
int len;
len = _swprintf_p(buffer, BUFFER_SIZE, L"%2$s %1$d",
0, L" marbles in your head.");
_printf_p( "Wrote %d characters\n", len );
// _swprintf_p fails because string contains WEOF (\xffff)
len = _swprintf_p(buffer, BUFFER_SIZE, L"%s",
L"Hello\xffff world" );
_printf_p( "Wrote %d characters\n", len );
}
Wrote 24 characters
Wrote -1 characters
Siehe auch
Stream-E/A
_fprintf_p
, _fprintf_p_l
, _fwprintf_p
, _fwprintf_p_l
fprintf
, _fprintf_l
, fwprintf
, _fwprintf_l
_printf_p
, _printf_p_l
, _wprintf_p
, _wprintf_p_l
printf
, _printf_l
, wprintf
, _wprintf_l
sprintf
, _sprintf_l
, swprintf
, _swprintf_l
, __swprintf_l
scanf
, _scanf_l
, wscanf
, _wscanf_l
sscanf
, _sscanf_l
, swscanf
, _swscanf_l
sscanf_s
, _sscanf_s_l
, swscanf_s
, _swscanf_s_l
vprintf
-Funktionen
printf_p
Positionsparameter
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