_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Artikel
06/09/2015

Gibt die Anzahl der Zeichen in der formatierten Zeichenfolge, mit der Möglichkeit, die Reihenfolge anzugeben zurück, in der Parameter in der Formatzeichenfolge verwendet werden.

int _scprintf_p(
   const char *format [,
   argument] ... 
);
int _scprintf_p_l(
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _scwprintf_p (
   const wchar_t *format [,
   argument] ... 
);
int _scwprintf_p _l(
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Parameter

format
Formatsteuerzeichenfolge.
argument
Optionale Argumente.
locale
Das zu verwendende Gebietsschema.

Rückgabewert

Gibt die Anzahl von Zeichen zurück, die generiert werden, wenn die Zeichenfolge in einer Datei oder einem Puffer mithilfe der angegebenen Formatierungscodes gedruckt werden oder gesendet werden sollen. Der zurückgegebene Wert enthält nicht das NULL. _scwprintf_p führt die gleiche Aufgabe für Breitzeichen erfüllt.

Der Unterschied zwischen _scprintf_p und _scprintf ist, dass _scprintf_p positionelle Parameter unterstützt, wodurch festgelegt werden kann, in welcher Reihenfolge die Argumente in der Formatzeichenfolge verwendet werden. Weitere Informationen finden Sie unter printf_p-Positionsparameter.

Wenn format ein NULL-Zeiger ist, wird der Handler für ungültige Parameter aufgerufen, wie in Parametervalidierung beschrieben. Wenn die weitere Ausführung zugelassen wird, geben diese Funktionen "– 1" zurück und legen errno auf EINVAL fest.

Weitere Informationen über diese und andere Fehlercodes finden Sie unter _doserrno, errno, _sys_errlist und _sys_nerr.

Hinweise

Jedes argument (falls vorhanden) wird entsprechend der entsprechenden Formatangabe in format konvertiert. Das Format besteht aus normalen Zeichen und hat die gleiche Form und Funktion wie das format-Argument für printf.

Die Versionen dieser Funktionen mit dem _l-Suffix sind beinahe identisch, verwenden jedoch den ihnen übergebenen Gebietsschemaparameter anstelle des aktuellen Threadgebietsschemas.

Sicherheitshinweis
Stellen Sie sicher, dass format keine benutzerdefinierte Zeichenfolge ist.

Zuordnung generischer Textroutinen

Tchar.h-Routine	_UNICODE und _MBCS nicht definiert	_MBCS definiert	_UNICODE definiert
_sctprintf_p	_scprintf_p	_scprintf_p	_scwprintf_p
_sctprintf_p_l	_scprintf_p_l	_scprintf_p_l	_scwprintf_p_l

Anforderungen

Routine	Erforderlicher Header
_scprintf_p, _scprintf_p_l	<stdio.h>
_scwprintf_p, _scwprintf_p_l	<stdio.h> oder <wchar.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Siehe auch

Referenz

Stream-E/A

_scprintf, _scprintf_l, _scwprintf, _scwprintf_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Freigeben über