_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Article
06/09/2015

Mettre en forme et afficher dans la console. Des versions plus 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 le Windows Runtime.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 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) 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. Contrairement aux fonctions fprintf, printf, et sprintf, ni _cprintf, ni _cwprintf 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 affiche les caractères Unicode lorsqu'elle est utilisée dans Windows NT. Contrairement à _cprintf, _cwprintf, elle utilise les paramètres régionaux de console.

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.

_cprintf valide les paramètres format. Si format est un pointeur null, la fonction appelle le gestionnaire de paramètres invalides comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, la fonction retourne -1 et définit errno avec la valeur EINVAL.

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
_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 sur la compatibilité, consultez Compatibilité.

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