_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Article
06/09/2015

Retourne le nombre de caractères dans la chaîne mise en forme à 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 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 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 effectue la même fonction pour des caractères larges.

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.

Notes

Chaque argument (si il y en a) est converti selon la spécification du format correspondant format. Le format se compose de caractères ordinaires et a la même forme et fonction que l'argument format pour printf.

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.