vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l

Article
06/09/2015

Entrez la sortie mise en forme à l'aide d'un pointeur vers une liste d'arguments. plus les versions sécurisées de ces fonctions existent ; consultez vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l.

int vfprintf(
   FILE *stream,
   const char *format,
   va_list argptr 
);
int _vfprintf_l(
   FILE *stream,
   const char *format,
   locale_t locale,
   va_list argptr 
);
int vfwprintf(
   FILE *stream,
   const wchar_t *format,
   va_list argptr 
);
int _vfwprintf_l(
   FILE *stream,
   const wchar_t *format,
   locale_t locale,
   va_list argptr 
);

Paramètres

stream
Pointeur vers la structure d' FILE .
format
Spécification 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

vfprintf et vfwprintf retournent le nombre de caractères entrés, sans le caractère NULL de fin, ou une valeur négative si une erreur de sortie se produit. si stream ou format est un pointeur null, le gestionnaire de paramètre non valide est appelé, comme décrit dans Validation de paramètre. Si est autorisé à l'exécution de se poursuivre, les fonctions retournent -1 et errno défini à EINVAL.

Pour plus d'informations sur ces éléments et d'autres codes d'erreur, consultez _doserrno, errno, _sys_errlist, et _sys_nerr.

Notes

Chacune de ces fonctions prend un pointeur vers une liste d'arguments, puis les formats et écrit les données données à stream.

vfwprintf est la version à caractère élargi d' vfprintf; les deux fonctions se comportent de la même si le flux est ouvert en mode ANSI. vfprintf ne prend pas en charge actuellement la sortie dans un flux d'UNICODE.

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.

Note de sécurité
assurez-vous qu' format n'est pas une chaîne définie par l'utilisateur.Pour plus d'informations, consultez Solutions contre les dépassements de mémoire tampon.