_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Article
06/09/2015

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

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.

Valeur de retour

Le nombre de caractères imprimés ou une valeur négative si une erreur se produit.

Notes

Ces fonctions mettent en forme et affichent une série de caractères et de valeurs directement dans la console à l'aide des fonctions _putch et _putwch 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_p. La différence entre _cprintf_p et cprintf_s est que _cprintf_p prend en charge les paramètres positionnels, qui permettent 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, ni _cprintf_p, ni _cwprintf_p 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_p affiche les caractères Unicode lorsqu'elle est utilisée dans Windows NT. Contrairement à _cprintf_p, _cwprintf_p, 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.

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

En outre, comme _cprintf_s et _cwprintf_s, ils 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 invalides, ces fonctions appellent un 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 attribuent à errno 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

Configuration requise

Routine	En-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 Compatibilité.

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