_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Article
03/04/2013

Retourne le nombre de caractères dans la chaîne mise en forme, avec la possibilité de spécifier l'ordre dans lequel les paramètres sont utilisés dans la chaîne de format.

int _scprintf_p(
   const char *format [,
   argument] ... 
);
int _scprintf_p_l(
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _scwprintf_p (
   const wchar_t *format [,
   argument] ... 
);
int _scwprintf_p _l(
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

Paramètres

format
Chaîne de format.
argument
arguments facultatifs.
locale
Les paramètres régionaux à utiliser.

Valeur de retour

Retourne le nombre de caractères qui sera généré si la chaîne doivent être imprimées ou envoyées à 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._scwprintf_p exécute la même fonction pour les caractères larges.

La différence entre _scprintf_pet _scprintfest qu' _scprintf_pprend en charge les paramètres positionnels, qui permet de spécifier l'ordre dans lequel les arguments sont utilisés dans la chaîne de format.Pour plus d'informations, consultez paramètres positionnels de printf_p.

si format est un pointeur d' 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, ces 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

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.

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.

mappages de routines de texte générique

routine de Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_sctprintf_p	_scprintf_p	_scprintf_p	_scwprintf_p
_sctprintf_p_l	_scprintf_p_l	_scprintf_p_l	_scwprintf_p_l

Configuration requise

routine	en-tête requis
_scprintf_p, _scprintf_p_l	<stdio.h>
_scwprintf_p, _scwprintf_p_l	<stdio.h> ou <wchar.h>

Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.

Voir aussi

Référence

E/S de flux

_scprintf, _scprintf_l, _scwprintf, _scwprintf_l

_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l

Partager via