Partager via


_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Formats et imprime sur la console.Les versions sécurisées sont disponibles ; consultez _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

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( 
   const char * format [, 
   argument] ... 
);
int _cprintf_l( 
   const char * format,
   locale_t locale [,
   argument] … 
);
int _cwprintf(
   const wchar * format [, 
   argument] …
);
int _cwprintf_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 d'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) 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 .Contrairement à fprintf, d' printf, et les fonctions d' sprintf, ni _cprintf ni _cwprintf 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 affiche des caractères Unicode en cas de utilisation dans Windows NT.Contrairement à _cprintf, _cwprintf 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.

_cprintf valide le paramètre d' format .Si format est un pointeur null, la fonction appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, la fonction retourne -1 et définit errno à EINVAL.

Note de sécurité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 de Tchar.h

_UNICODE et non définis _MBCS

_MBCS défini

_UNICODE défini

_tcprintf

_cprintf

_cprintf

_cwprintf

_tcprintf_l

_cprintf_l

_cprintf_l

_cwprintf_l

Configuration requise

Routine

En-tête requis

_cprintf,_cprintf_l

<conio.h>

_cwprintf, _cwprintf_l

<conio.h>

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

Exemple

// crt_cprintf.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( "%d  %.4x  %u  %c %s\r\n", i, h, u, c, s );
}
  

Équivalent .NET Framework

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez l' Exemples d'appel de code non managé.

Voir aussi

Référence

E/S de console et de port

_cscanf, _cscanf_l, _cwscanf, _cwscanf_l

fprintf, _fprintf_l, fwprintf, _fwprintf_l

printf, _printf_l, wprintf, _wprintf_l

sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l

_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Syntaxe de spécification de format : fonctions printf et wprintf