_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

Met en forme et affiche les informations dans la console. Ces versions de _cprintf, , _cprintf_l, _cwprintf, _cwprintf_l ont des améliorations de sécurité, comme décrit dans les fonctionnalités de sécurité dans le CRT.

Important

Cette API ne peut pas être utilisée dans les applications qui s’exécutent dans le Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge dans les applications de la plateforme Windows universelle.

Syntaxe

int _cprintf_s(
   const char * format [,
   argument] ...
);
int _cprintf_s_l(
   const char * format,
   _locale_t locale [,
   argument] ...
);
int _cwprintf_s(
   const wchar * format [,
   argument] ...
);
int _cwprintf_s_l(
   const wchar * format,
   _locale_t locale [,
   argument] ...
);

Paramètres

format
Chaîne de contrôle de format.

argument
Paramètres facultatifs.

locale
Paramètres régionaux à utiliser.

Valeur retournée

Nombre de caractères affichés.

Notes

Ces fonctions mettent en forme et affichent toute une série de caractères et de valeurs directement dans la console, en se servant de la fonction _putch (_putwch pour _cwprintf_s) pour effectuer la sortie des caractères. Chaque argument (le cas échéant) est converti et sorti selon la spécification de format correspondante dans format. Le format a le même formulaire et la même fonction que le format paramètre de la printf_s fonction. Contrairement aux fprintf_scombinaisons , printf_set sprintf_s fonctions et _cwprintf_s_cprintf_s ne traduisent pas les caractères de saut de ligne en combinaisons de retour chariot (CR-LF) lors de la sortie.

Il existe une différence importante : _cwprintf_s affiche les caractères Unicode dans Windows NT. Contrairement à _cprintf_s, _cwprintf_s utilise les paramètres régionaux de la console active.

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 actuels.

Important

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

À compter de Windows 10 version 2004 (build 19041), la printf famille de fonctions imprime exactement des nombres à virgule flottante pouvant être représentés en fonction des règles IEEE 754 pour l’arrondi. Dans les versions précédentes de Windows, les nombres à virgule flottante qui se terminent exactement par « 5 » sont toujours arrondis. IEEE 754 indique qu’ils doivent arrondir au chiffre pair le plus proche (également appelé « Arrondi du banquier »). Par exemple, les deux printf("%1.0f", 1.5) et printf("%1.0f", 2.5) doivent arrondir à 2. Auparavant, 1,5 arrondirait à 2 et 2,5 arrondirait à 3. Cette modification affecte uniquement les nombres représentant exactement. Par exemple, la version 2.35 (qui, lorsqu’elle est représentée en mémoire, est plus proche de 2,350000000000008) continue d’arrondir jusqu’à 2,4. L’arrondi effectué par ces fonctions respecte désormais également le mode d’arrondi à virgule flottante défini par fesetround. Auparavant, l’arrondi a toujours choisi FE_TONEAREST le comportement. Cette modification affecte uniquement les programmes générés à l’aide de Visual Studio 2019 version 16.2 et ultérieures. Pour utiliser le comportement d’arrondi à virgule flottante héritée, lien avec « legacy_stdio_float_rounding.obj ».

Comme les versions non sécurisées (voir _cprintf, , _cwprintf_cprintf_l, ), _cwprintf_lces fonctions valident leurs paramètres et appellent le gestionnaire de paramètres non valides, comme décrit dans validation de paramètre, s’il s’agit format d’un pointeur Null. Ces fonctions diffèrent des versions non sécurisées en ce sens que la chaîne de format elle-même est également validée. S’il existe des spécificateurs de mise en forme inconnus ou incorrects, ces fonctions appellent le gestionnaire de paramètres non valides. Dans tous les cas, si l’exécution est autorisée à se poursuivre, les fonctions retournent -1 et définissent errno avec la valeur EINVAL.

Mappages de routine de texte générique

Routine Tchar.h	_UNICODE et _MBCS non défini	_MBCS Défini	_UNICODE Défini
_tcprintf_s	_cprintf_s	_cprintf_s	_cwprintf_s
_tcprintf_s_l	_cprintf_s_l	_cprintf_s_l	_cwprintf_s_l

Spécifications

Routine	En-tête requis
_cprintf_s, _cprintf_s_l	<conio.h>
_cwprintf_s, _cwprintf_s_l	<conio.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility.

Bibliothèques

Toutes les versions des bibliothèques Runtime C.

Exemple

// crt_cprintf_s.c
// compile with: /c
// This program displays some variables to the console.

#include <conio.h>

int main( void )
{
   int      i = -16, h = 29;
   unsigned u = 62511;
   char     c = 'A';
   char     s[] = "Test";

   /* Note that console output does not translate \n as
    * standard output does. Use \r\n instead.
    */
   _cprintf_s( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}

-16  001d  62511  A Test

Voir aussi

E/S de console et de port
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l
printf_s, _printf_s_l, wprintf_s, _wprintf_s_l
sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l
vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l
Syntaxe de spécification de format : printf et wprintf fonctions