_cprintf, _cprintf_l, _cwprintf, _cwprintf_l_cprintf, _cprintf_l, _cwprintf, _cwprintf_l

Met en forme et affiche les informations dans la console.Formats and prints to the console. Des versions plus sécurisées sont disponibles. Consultez _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.More-secure versions are available; see _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l.

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(
   const char * format [, argument_list]
);
int _cprintf_l(
   const char * format,
   locale_t locale [, argument_list]
);
int _cwprintf(
   const wchar * format [, argument_list]
);
int _cwprintf_l(
   const wchar * format,
   locale_t locale [, argument_list]
);

ParamètresParameters

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

argument_listargument_list
Paramètres facultatifs pour la chaîne de format.Optional parameters for the format string.

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

Valeur de retourReturn Value

Nombre de caractères affichés.The number of characters printed.

NotesRemarks

Ces fonctions mettent en forme et impriment une série de caractères et de valeurs directement dans la console, en utilisant la fonction _putch ( _putwch pour _cwprintf) pour les caractères de sortie.These functions format and print a series of characters and values directly to the console, using the _putch function (_putwch for _cwprintf) to output characters. Chaque argument dans argument_list (le cas échéant) est converti et sorti selon la spécification de format correspondante au format.Each argument in argument_list (if any) is converted and output according to the corresponding format specification in format. L’argument format utilise la syntaxe de spécification de format pour les fonctions printf et wprintf.The format argument uses the format specification syntax for printf and wprintf functions. Contrairement aux fonctions fprintf, printfet sprintf , ni _cprintf ni _cwprintf 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, printf, and sprintf functions, neither _cprintf nor _cwprintf translates line-feed characters into carriage return-line feed (CR-LF) combinations when output.

Une distinction importante est que _cwprintf affiche les caractères Unicode lorsqu’ils sont utilisés dans Windows.An important distinction is that _cwprintf displays Unicode characters when used in Windows. Contrairement à _cprintf, _cwprintf utilise les paramètres régionaux de la console actuelle.Unlike _cprintf, _cwprintf 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.

_cprintf valide le paramètre de format ._cprintf validates the format parameter. Si format est un pointeur null, la fonction appelle le gestionnaire de paramètre non valide, comme décrit dans validation de paramètre.If format is a null pointer, the function invokes the invalid parameter handler, as described in Parameter Validation. Si l’exécution est autorisée à se poursuivre, la fonction retourne-1 et définit errno sur EINVAL.If execution is allowed to continue, the function returns -1 and sets errno to EINVAL.

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.

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_tcprintf _cprintf_cprintf _cprintf_cprintf _cwprintf_cwprintf
_tcprintf_l_tcprintf_l _cprintf_l_cprintf_l _cprintf_l_cprintf_l _cwprintf_l_cwprintf_l

Configuration requiseRequirements

RoutineRoutine En-tête requisRequired header
_cprintf, _cprintf_l_cprintf, _cprintf_l <conio.h><conio.h>
_cwprintf, _cwprintf_l_cwprintf, _cwprintf_l <conio.h><conio.h>

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

ExempleExample

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

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
fprintf, _fprintf_l, fwprintf, _fwprintf_lfprintf, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_lprintf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_lvfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l
_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l
_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l
Syntaxe de spécification de format : fonctions printf et wprintfFormat Specification Syntax: printf and wprintf Functions