_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

Article
03/26/2013

Formats et imprime sur la console.Ce sont des versions de _cprintf, _cprintf_l, _cwprintf, _cwprintf_l avec des améliorations de sécurité comme décrit dans Fonctionnalités de sécurité du CRT.

Important

Cette API ne peut pas être utilisée dans les applications qui s'exécutent dans les fenêtres d'exécution.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 format.
argument
Paramètres facultatifs.
locale
Les paramètres régionaux à utiliser.

Valeur de retour

Le nombre de caractères imprimés.

Notes

Ces fonctions format et impriment un ensemble de caractères et des valeurs directement dans la console, à l'aide de la fonction d' _putch (_putwch pour _cwprintf_s) pour sortir les caractères.Chaque argument (le cas échéant) est converti et de sortie en fonction de la spécification du format correspondante dans format.Le format a la même forme et fonction de le paramètre d' format pour la fonction d' printf_s .Contrairement à fprintf_s, d' printf_s, et les fonctions d' sprintf_s, ni _cprintf_s ni _cwprintf_s ne convertit les caractères de retour à la ligne en mélanges de la puissance de retour- ligne de chariot (CR-LF) une fois sortie.

Une distinction importante est que _cwprintf_s affiche des caractères Unicode en cas de utilisation dans Windows NT.Contrairement à _cprintf_s, _cwprintf_s utilise les paramètres régionaux de console

Les versions de ces fonctions avec le suffixe d' _l sont identiques sauf qu'elles utilisent le paramètre de paramètres régionaux passé au lieu des paramètres régionaux.

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 des paramètres, 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 est inconnu ou spécificateurs de format incorrect formés, ces fonctions appelle le gestionnaire de paramètre non valide.Dans tous les cas, s'il permet à l'exécution pour continuer, retournent -1 de fonctions et le positionnement errno à EINVAL.

Mappages de routines de texte générique

Routine de Tchar.h	_UNICODE et non définis _MBCS	_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 de compatibilité, consultez l' Compatibilité dans l'introduction.

Bibliothèques

Toutes les versions d' 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 );
}