_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l
Retourne le nombre de caractères dans la chaîne mise en forme à l'aide d'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 format.argptr
Pointeur vers la liste d'arguments.locale
Les 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 sera généré si la chaîne désignée par la liste d'arguments est imprimée ou envoyée à un fichier ou une mémoire tampon utilisant les codes de mise en forme spécifiés.La valeur retournée n'inclut pas le caractère NULL de fin._vscwprintf_p exécute la même fonction pour les caractères larges.
Notes
Ces fonctions et ceux d' _vscprintf et d' _vscwprintf uniquement dans la mesure où 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.
Les versions de ces fonctions par le suffixe d' _l sont identiques mais elles utilisent le paramètre de paramètres régionaux passé au lieu des paramètres régionaux du thread courant.
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 de se poursuivre, les fonctions retournent -1 et errno défini à EINVAL.
Note de sécurité |
---|
Vérifiez que si format est une chaîne définie par l'utilisateur, cette valeur est null terminé et que le nombre et le type de paramètres.Pour plus d'informations, consultez Solutions contre les dépassements de mémoire tampon. |
mappages de routines de texte générique
routine de TCHAR.H |
_MBCS & de _UNICODE non défini |
_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 des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.
Exemple
Consultez l'exemple pour vsprintf.