_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

 

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

Met en forme et affiche les informations sur la console, et prend en charge les paramètres positionnels dans la chaîne de format.

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_p(   
   const char * format [,   
   argument] ...   
);  
int _cprintf_p_l(   
   const char * format,  
   locale_t locale [,   
   argument] ...   
);  
int _cwprintf_p(  
   const wchar * format [,   
   argument] ...  
);  
int _cwprintf_p_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.

Nombre de caractères affichés ou valeur négative en cas d'erreur.

Ces fonctions mettent en forme et affichent toute une série de caractères et de valeurs directement dans la console, en se servant des fonctions _putch et _putwch pour effectuer la sortie 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 la format paramètre pour le printf_p (fonction). La différence entre _cprintf_p et cprintf_s vient du fait que _cprintf_p prend en charge les paramètres positionnels, ce qui vous permet de spécifier l'ordre dans lequel les arguments sont utilisés dans la chaîne de format. Pour plus d’informations, consultez paramètres positionnels printf_p.

Contrairement aux fonctions fprintf_p, printf_p et sprintf_p, les fonctions _cprintf_p et _cwprintf_p 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_p affiche les caractères Unicode lorsqu’il est utilisé dans Windows NT. Contrairement à _cprintf_p, _cwprintf_p 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.

System_CAPS_ICON_important.jpg Important

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

En outre, tout comme _cprintf_s et _cwprintf_s, elles valident le pointeur d'entrée et la chaîne de format. Si format ou argument sont NULL, ou du format de chaîne contient des caractères de mise en forme non valides, ces fonctions appellent le Gestionnaire de paramètre non valide, comme décrit dans Validation de paramètre. Si l'exécution est autorisée à se poursuivre, ces fonctions retournent -1 et définissent errno avec la valeur 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_p_cprintf_p_cprintf_p_cwprintf_p
_tcprintf_p_l_cprintf_p_l_cprintf_p_l_cwprintf_p_l
RoutineEn-tête requis
_cprintf_p,_cprintf_p_l<conio.h>
_cwprintf_p,_cwprintf_p_l<conio.h>

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

// crt_cprintf_p.c  
// This program displays some variables to the console  
// using the _cprintf_p function.  
  
#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_p( "%2$d  %1$.4x  %3$u  %4$c %5$s\r\n",   
                h, i, u, c, s );  
}  

-16  001d  62511  A Test  

Console et Port e/s
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l
_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l
fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l
_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l
printf_s, _printf_s_l, wprintf_s, _wprintf_s_l
_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l
_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
Paramètres positionnels printf_p
Syntaxe de spécification de format : les fonctions printf et wprintf

Afficher: