_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

Article
06/09/2015

Mettre en forme et afficher dans la console. Ces versions _cprintf, _cprintf_l, _cwprintf, _cwprintf_l présentent des améliorations de sécurité, comme décrit dans 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 avec /ZW.

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 de retour

Nombre de caractères copiés.

Notes

Ces fonctions mettent en forme et affichent une série de caractères et de valeurs directement dans la console, à l'aide de la fonction _putch (_putwch pour _cwprintf_s ) afin d'afficher 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 la même forme et fonction que le paramètre format pour la fonction printf_p. Contrairement aux fonctions fprintf_s, printf_s, et sprintf_s, ni _cprintf_s, ni _cwprintf_s ne traduit les caractères de retour à la ligne en combinaisons de caractères de retour à la ligne et de retour chariot (CR-LF) lorsqu'ils sont tapés.

Une distinction importante est que _cwprintf_s affiche les caractères Unicode lorsqu'elle est utilisée dans Windows NT. Contrairement à _cprintf_s, _cwprintf_s utilise les paramètres régionaux de console actuels.

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.

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

Comme les versions non sécurisées (consultez _cprintf, _cprintf_l, _cwprintf, _cwprintf_l), ces fonctions valident leurs paramètres et appellent le gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre, si format est un pointeur null. Ces fonctions diffèrent des versions non sécurisées car la chaîne de format elle-même est également validée. S'il existe des spécificateurs de format inconnus ou mal formés, ces fonctions appellent le gestionnaire de paramètre non valide. Dans tous les cas, si l'exécution est autorisée à se poursuivre, ces fonctions retournent -1 et définissent errno à EINVAL .

Mappages de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_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

Configuration requise

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 Compatibilité.

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 );
}