_vscprintf, _vscprintf_l, _vscwprintf, _vscwprintf_l

Article
03/04/2013

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.