_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l

Article
06/09/2015

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 contrôle de format.
argument
Arguments facultatifs.
locale
Paramètres régionaux à utiliser.

Valeur de retour

Retourne le nombre de caractères qui seraient générés si la chaîne devaient être imprimée ou envoyée dans 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. _scwprintf_p effectue la même fonction pour des caractères larges.

La différence entre _scprintf_p et _scprintf est que _scprintf_p prend en charge les paramètres positionnels, qui permettent 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 printf_p.

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, ces fonctions retournent -1 et attribuent à errno la valeur EINVAL.

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

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.

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.

Note de sécurité
Assurez-vous que format n'est pas une chaîne définie par l'utilisateur.

Mappages de routines de texte générique

Routine 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 sur la 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