_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l

Article
03/26/2013

Entrez la sortie mise en forme à l'aide d'un pointeur à une liste d'arguments, avec la capacité de spécifier l'ordre dans lequel les arguments sont utilisés.

int _vprintf_p(
   const char *format,
   va_list argptr 
);
int _vprintf_p_l(
   const char *format,
   locale_t locale,
   va_list argptr 
);
int _vwprintf_p(
   const wchar_t *format,
   va_list argptr 
);
int _vwprintf_p_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

_vprintf_p et _vwprintf_p retournent le nombre de caractères entrés, sans le caractère NULL de fin, ou une valeur négative si une erreur de sortie se produit.

Notes

Chacune de ces fonctions prend un pointeur vers une liste d'arguments, puis aux formats et les écrit les données données à stdout.Ces fonctions diffèrent d' vprintf_s et d' vwprintf_s uniquement du fait qu'elles prennent en charge la capacité de spécifier l'ordre dans lequel les arguments sont utilisés.Pour plus d'informations, consultez paramètres positionnels de printf_p.

_vwprintf_p est la version à caractère élargi d' _vprintf_p; les deux fonctions se comportent de la même si le flux est ouvert en mode ANSI._vprintf_p ne prend pas en charge actuellement la sortie dans un flux d'UNICODE.

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 du thread actuel.

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.

Si format est un pointeur null, ou si la chaîne de format contient des caractères de disposition incorrects, 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, les fonctions retournent -1 et affectez errno à EINVAL.

Mappages de routines de texte générique

Routine de TCHAR.H	_UNICODE et non définis _MBCS	_MBCS défini	_UNICODE défini
_vtprintf_p	_vprintf_p	_vprintf_p	_vwprintf_p
_vtprintf_p_l	_vprintf_p_l	_vprintf_p_l	_vwprintf_p_l

Configuration requise

Routine	En-tête requis	En-têtes facultatifs
_vprintf_p, _vprintf_p_l	<stdio.h> et <stdarg.h>	<varargs.h>*
_vwprintf_p, _vwprintf_p_l	<stdio.h> ou <wchar.h>, et <stdarg.h>	<varargs.h>*

* Requis pour la compatibilité UNIX V.

La console n'est pas prise en charge dans les applications d' Windows Store .Les handles standard de flux de données associés à la console, stdin, stdout, et stderr, doivent être redirigés pour que les fonctions runtime C peuvent les utiliser dans des applications d' Windows Store .Pour des informations de compatibilité supplémentaires, consultez l' Compatibilité dans l'introduction.