_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l
Retourne le nombre de caractères dans la chaîne mise en forme à l'aide d'un pointeur vers une liste d'arguments.
int _vscprintf(
const char *format,
va_list argptr
);
int _vscprintf_l(
const char *format,
locale_t locale,
va_list argptr
);
int _vscwprintf(
const wchar_t *format,
va_list argptr
);
int _vscwprintf_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 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 exécute la même fonction pour les caractères larges.
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.
Notes
Chaque argument (le cas échéant) est converti en fonction de la spécification du format correspondante dans format.Le format est constituée de caractères ordinaires et a le même formulaire et fonction que l'argument d' format pour printf.
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 |
_vscprintf |
_vscprintf |
_vscwprintf |
_vsctprintf_l |
_vscprintf_l |
_vscprintf_l |
_vscwprintf_l |
Configuration requise
routine |
en-tête requis |
---|---|
_vscprintf, _vscprintf_l |
<stdio.h> |
_vscwprintf, _vscwprintf_l |
<stdio.h> ou <wchar.h> |
Pour des informations de compatibilité supplémentaires, consultez compatibilité dans l'introduction.
Exemple
Consultez l'exemple pour vsprintf.
Voir aussi
Référence
fprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
scanf, _scanf_l, wscanf, _wscanf_l