_cprintf_p, , _cprintf_p_l_cwprintf_p, ,_cwprintf_p_l

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

Syntaxe

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.

Valeur retournée

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

Notes

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 le même formulaire et la même fonction que le format paramètre de la 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 fprintf_pcombinaisons , printf_pet sprintf_p fonctions et _cwprintf_p _cprintf_p ne traduisent pas les caractères de saut de ligne en combinaisons de retour chariot (CR-LF) lors de la sortie. Il existe une différence importante : _cwprintf_p affiche les caractères Unicode 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.

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 si la chaîne de format contient des caractères de mise en forme non valides, ces fonctions appellent le gestionnaire de paramètres non valide, comme décrit dans la validation des paramètres. 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

Spécifications

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

Exemple

// 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

Voir aussi

E/S de console et de port
_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_lfwprintf_s, ,_fwprintf_s_l
_printf_p, , _printf_p_l_wprintf_p, ,_wprintf_p_l
printf_s, , _printf_s_lwprintf_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 : printf et wprintf fonctions