_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l

Article
03/26/2013

Entrez la sortie mise en forme à la console à l'aide d'un pointeur à une liste d'arguments.Les versions sécurisées de ces fonctions sont disponibles, consultez _vcprintf_s, _vcprintf_s_l, _vcwprintf_s, _vcwprintf_s_l.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.Pour plus d'informations, consultez Fonctions CRT non prises en charge avec /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
);

Paramètres

format
Spécification de format.
argptr
Pointeur vers la liste d'arguments.
locale
Les paramètres régionaux à utiliser.

Pour plus d'informations, consultez l' Spécifications de format.

Valeur de retour

Le nombre de caractères entrés, ou une valeur négative si une erreur de sortie se produit.Si format est un pointeur null, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, errno a la valeur EINVAL et -1 est retourné.

Notes

Chacune de ces fonctions prend un pointeur vers une liste d'arguments, puis aux formats et les écrit les données données dans la console._vcwprintf est la version à caractère élargi d' _vcprintf.Elle prend une chaîne à caractères larges comme argument.

Les versions de ces fonctions avec le suffixe d' _l sont identiques sauf qu'elles utilisent le paramètre de paramètres régionaux passé au lieu des paramètres régionaux.

Note de sécurité
Assurez-vous que format n'est pas une chaîne définie par l'utilisateur.Pour plus d'informations, consultez l' Solutions contre les dépassements de mémoire tampon.

Mappages de routines de texte générique

Routine de TCHAR.H	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_vtcprintf	_vcprintf	_vcprintf	_vcwprintf
_vtcprintf_l	_vcprintf_l	_vcprintf_l	_vcwprintf_l

Configuration requise

Routine	En-tête requis	En-têtes facultatifs
_vcprintf, _vcprintf_l	<conio.h> et <stdarg.h>	<varargs.h>*
_vcwprintf, _vcwprintf_l	<conio.h> ou <wchar.h>, et <stdarg.h>	<varargs.h>*

* Requis pour la compatibilité UNIX V.

Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.

Exemple

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