_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

Artikel
03/12/2013

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.

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

Sicherheitshinweis
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 );
}