_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l
Write formatierte Ausgabe an die Konsole mithilfe eines Zeigers auf eine Liste der Argumente.Sicherere Versionen dieser Funktionen sind, finden _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l verfügbar.
![]() |
---|
Diese API kann nicht in den Anwendungen verwendet werden, die in der Windows Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW. |
int _vcprintf( const char* format, va_list argptr ); int _vcprintf_l( const char* format, locale_t locale, va_list argptr ); int _vcwprintf( const wchar_t* format, va_list argptr ); int _vcwprintf_l( const wchar_t* format, locale_t locale, va_list argptr );
Parameter
format
Formatangabe.argptr
Zeiger auf die Liste der Argumente.locale
Das Gebietsschema zu verwenden.
Weitere Informationen finden Sie unter Formatangaben.
Rückgabewert
Die Anzahl der Zeichen geschrieben oder ein negativer Wert, wenn ein Ausgabefehler auftritt.Wenn format ein NULL-Zeiger ist, wird der ungültige Parameterhandler aufgerufen, wie in Parametervalidierung beschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno zu EINVAL festgelegt und -1 wird zurückgegeben.
Hinweise
Jede dieser Funktionen verwendet einen Zeiger auf eine Argumentliste, dann Stilen und schreibt die angegebenen Daten an die Konsole aus._vcwprintf ist die Breitzeichen-Version von _vcprintf.Sie nimmt eine Zeichenfolge mit Breitzeichen als Argument.
Die Versionen dieser Funktionen mit dem _l Suffix sind identisch, allerdings verwenden den Gebietsschemaparameter in, der anstelle des aktuellen Gebietsschemas übergeben wird.
![]() |
---|
Stellen Sie sicher, dass format keine benutzerdefinierte Zeichenfolge ist.Weitere Informationen finden Sie unter Vermeiden von Pufferüberläufen. |
Zuordnung generische Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert. |
_MBCS definiert |
_UNICODE definiert |
---|---|---|---|
_vtcprintf |
_vcprintf |
_vcprintf |
_vcwprintf |
_vtcprintf_l |
_vcprintf_l |
_vcprintf_l |
_vcwprintf_l |
Anforderungen
Routine |
Erforderlicher Header |
Optionale Header |
---|---|---|
_vcprintf, _vcprintf_l |
<conio.h> und <stdarg.h> |
<varargs.h>* |
_vcwprintf, _vcwprintf_l |
<conio.h> oder <wchar.h>und <stdarg.h> |
<varargs.h>* |
* Benötigt für Kompatibilität UNIX V.
So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität in der Einführung.
Beispiel
// crt_vcprintf.cpp
// compile with: /c
#include <conio.h>
#include <stdarg.h>
// An error formatting function used to print to the console.
int eprintf(const char* format, ...)
{
va_list args;
va_start(args, format);
return _vcprintf(format, args);
}
int main()
{
eprintf(" (%d:%d): Error %s%d : %s\n", 10, 23, "C", 2111,
"<some error text>");
eprintf(" (Related to symbol '%s' defined on line %d).\n",
"<symbol>", 5 );
}
.NET Framework-Entsprechung
Siehe auch
Referenz
_cprintf, _cprintf_l, _cwprintf, _cwprintf_l
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l