_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l
Retourne le nombre de caractères dans la chaîne formatée en utilisant un pointeur vers une liste d'arguments, avec la possibilité de spécifier l'ordre dans lequel les arguments sont utilisés.
int _vscprintf_p(
const char *format,
va_list argptr
);
int _vscprintf_p _l(
const char *format,
locale_t locale,
va_list argptr
);
int _vscwprintf_p (
const wchar_t *format,
va_list argptr
);
int _vscwprintf_p _l(
const wchar_t *format,
locale_t locale,
va_list argptr
);
Paramètres
format
Chaîne de contrôle de format.argptr
Pointeur vers la liste d'arguments.locale
Paramètres régionaux à utiliser.
Pour plus d'informations, consultez Spécifications de format.
Valeur de retour
_vscprintf_p retourne le nombre de caractères qui sont générés si la chaîne désignée par la liste d'arguments est imprimée ou envoyée à un fichier ou dans une mémoire tampon à l'aide de codes de mise en forme spécifiés. La valeur retournée n'inclut pas le caractère NULL terminant la chaine. _vscwprintf_p effectue la même fonction pour des caractères larges.
Notes
Ces fonctions diffèrent de _vscprintf et _vscwprintf seulement car 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 printf_p.
Les versions de ces fonctions avec le suffixe _l sont identiques, sauf qu'elles utilisent les paramètres régionaux passés au lieu des paramètres régionaux du thread actuel.
Si format est un pointeur null, le gestionnaire de paramètres non valides est appelé, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, cette fonction renvoient -1 et définie errno avec la valeur EINVAL.
Note de sécurité |
---|
Vérifiez que si format est une chaîne définie par l'utilisateur, elle a la valeur NULL à la fin et a le nombre et le type des paramètres corrects.Pour plus d'informations, consultez Solutions contre les dépassements de mémoire tampon. |
Mappages de routines de texte générique
Routine TCHAR.H |
_UNICODE & _MBCS non définis |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_vsctprintf_p |
_vscprintf_p |
_vscprintf_p |
_vscwprintf_p |
_vsctprintf_p_l |
_vscprintf_p_l |
_vscprintf_p_l |
_vscwprintf_p_l |
Configuration requise
Routine |
En-tête requis |
---|---|
_vscprintf_p, _vscprintf_p_l |
<stdio.h> |
_vscwprintf_p, _vscwprintf_p_l |
<stdio.h> ou <wchar.h> |
Pour plus d'informations sur la compatibilité, consultez Compatibilité dans l'introduction.
Exemple
Voyez l'exemple pour vsprintf.