_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

 

Pour obtenir la dernière documentation sur Visual Studio 2017 RC, consultez Documentation Visual Studio 2017 RC.

Met en forme et l’imprime sur la console. Versions plus sécurisées sont disponibles. consultez la page _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

System_CAPS_ICON_important.jpg 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.

Le nombre de caractères imprimés.

Thesefunctions formatage et impression d’une série de caractères et les valeurs directement dans la console, à l’aide de la _putch (fonction) (_putwch pour _cwprintf) et les caractères de sortie. 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 la format paramètre pour le printf (fonction). Contrairement aux fonctions fprintf, printf et sprintf, les fonctions _cprintf et _cwprintf ne traduisent pas les caractères de saut de ligne en combinaisons retour chariot-saut de ligne à leur sortie.

Une différence importante est que _cwprintf affiche les caractères Unicode lorsqu’il est utilisé dans Windows NT. Contrairement à _cprintf, _cwprintf 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.

_cprintfvalide les format paramètre. Si format est un pointeur null, la fonction appelle le Gestionnaire de paramètre non valide, 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.

System_CAPS_ICON_important.jpg Important

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
RoutineEn-tête requis
_cprintf,_cprintf_l<conio.h>
_cwprintf, _cwprintf_l<conio.h>

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

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

-16  001d  62511  A Test  

Non applicable. Pour appeler la fonction C standard, utilisez PInvoke. Pour plus d'informations, consultez Exemples d'appel de plateforme.

Console et Port e/s
_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 : les fonctions printf et wprintf

Afficher: