_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l_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.Formats and prints to the console, and supports positional parameters in the format string.

Important

Cette API ne peut pas être utilisée dans les applications qui s’exécutent dans le Windows Runtime.This API cannot be used in applications that execute in the Windows Runtime. Pour plus d’informations, consultez Fonctions CRT non prises en charge dans les applications de la plateforme Windows universelle.For more information, see CRT functions not supported in Universal Windows Platform apps.

SyntaxeSyntax

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ètresParameters

formatformat
Chaîne de contrôle de format.Format-control string.

argumentargument
Paramètres facultatifs.Optional parameters.

localelocale
Paramètres régionaux à utiliser.The locale to use.

Valeur de retourReturn Value

Nombre de caractères affichés ou valeur négative en cas d'erreur.The number of characters printed or a negative value if an error occurs.

NotesRemarks

Ces fonctions mettent en forme et impriment une série de caractères et de valeurs directement dans la console, à l’aide des fonctions _putch et _putwch pour les caractères de sortie.These functions format and print a series of characters and values directly to the console, using the _putch and _putwch functions to output characters. Chaque argument (le cas échéant) est converti et sorti selon la spécification de format correspondante au format.Each argument (if any) is converted and output according to the corresponding format specification in format. Le format a la même forme et la même fonction que le paramètre format pour la fonction printf_p .The format has the same form and function as the format parameter for the printf_p function. La différence entre _cprintf_p et cprintf_s est que _cprintf_p prend en charge les paramètres positionnels, ce qui permet de spécifier l’ordre dans lequel les arguments sont utilisés dans la chaîne de format.The difference between _cprintf_p and cprintf_s is that _cprintf_p supports positional parameters, which allows specifying the order in which the arguments are used in the format string. Pour plus d’informations, consultez Paramètres positionnels printf_p.For more information, see printf_p Positional Parameters.

Contrairement aux fonctions fprintf_p, printf_pet sprintf_p , ni _cprintf_p ni _cwprintf_p ne convertit les caractères de saut de ligne en combinaisons retour chariot-saut de ligne (CR-LF) lors de la sortie.Unlike the fprintf_p, printf_p, and sprintf_p functions, neither _cprintf_p nor _cwprintf_p translates line-feed characters into carriage return-line feed (CR-LF) combinations when output. Une distinction importante est que _cwprintf_p affiche les caractères Unicode lorsqu’il est utilisé dans Windows NT.An important distinction is that _cwprintf_p displays Unicode characters when used in Windows NT. Contrairement à _cprintf_p, _cwprintf_p utilise les paramètres régionaux de la console actuelle.Unlike _cprintf_p, _cwprintf_p uses the current console locale settings.

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.The versions of these functions with the _l suffix are identical except that they use the locale parameter passed in instead of the current locale.

Important

Assurez-vous que format n'est pas une chaîne définie par l'utilisateur.Ensure that format is not a user-defined string.

De plus, comme _cprintf_s et _cwprintf_s, ils valident le pointeur d’entrée et la chaîne de format.Also, like _cprintf_s and _cwprintf_s, they validate the input pointer and the format string. Si format ou argument a la valeur 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 valides, comme décrit dans validation de paramètre.If format or argument are NULL, or of the format string contains invalid formatting characters, these functions invoke the invalid parameter handler, as described in Parameter Validation. Si l’exécution est autorisée à se poursuivre, ces fonctions retournent-1 et attribuent à errno la valeur EINVAL.If execution is allowed to continue, these functions return -1 and set errno to EINVAL.

Mappages de routines de texte génériqueGeneric-Text Routine Mappings

Routine Tchar.hTchar.h routine _UNICODE et _MBCS non définis_UNICODE and _MBCS not defined _MBCS défini_MBCS defined _UNICODE défini_UNICODE defined
_tcprintf_p_tcprintf_p _cprintf_p_cprintf_p _cprintf_p_cprintf_p _cwprintf_p_cwprintf_p
_tcprintf_p_l_tcprintf_p_l _cprintf_p_l_cprintf_p_l _cprintf_p_l_cprintf_p_l _cwprintf_p_l_cwprintf_p_l

Configuration requiseRequirements

RoutineRoutine En-tête requisRequired header
_cprintf_p, _cprintf_p_l_cprintf_p, _cprintf_p_l <conio.h><conio.h>
_cwprintf_p, _cwprintf_p_l_cwprintf_p, _cwprintf_p_l <conio.h><conio.h>

Pour plus d'informations sur la compatibilité, voir Compatibilité.For more compatibility information, see Compatibility.

ExempleExample

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

E/S de console et de portConsole and Port I/O
_cscanf, _cscanf_l, _cwscanf, _cwscanf_l_cscanf, _cscanf_l, _cwscanf, _cwscanf_l
_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l
_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l
fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_lfprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l
_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l_printf_p, _printf_p_l, _wprintf_p, _wprintf_p_l
printf_s, _printf_s_l, wprintf_s, _wprintf_s_lprintf_s, _printf_s_l, wprintf_s, _wprintf_s_l
_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l
_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
Paramètres positionnels printf_pprintf_p Positional Parameters
Syntaxe de spécification de format : fonctions printf et wprintfFormat Specification Syntax: printf and wprintf Functions