_cprintf, , _cprintf_l_cwprintf, ,_cwprintf_l

Met en forme et affiche les informations dans la console. Des versions plus sécurisées sont disponibles ; voir , , _cwprintf_s_cprintf_s_l, _cwprintf_s_l._cprintf_s

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 dans les applications de la plateforme Windows universelle.

Syntaxe

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

format
Chaîne de contrôle de format.

argument_list
Paramètres facultatifs pour la chaîne de format.

locale
Paramètres régionaux à utiliser.

Valeur retournée

Nombre de caractères affichés.

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 de la fonction _putch (_putwch pour _cwprintf) pour effectuer la sortie des caractères. Chaque argument dans argument_list (le cas échéant) est converti et sortie en fonction de la spécification de format correspondante dans format. L’argument format utilise la syntaxe de spécification de format pour les fonctions printf et wprintf. Contrairement aux fprintfcombinaisons , printfet sprintf fonctions et _cwprintf _cprintf ne traduisent pas les caractères de saut de ligne en combinaisons de retour chariot (CR-LF) lors de la sortie.

Une distinction importante est que les caractères Unicode sont _cwprintf affichés lorsqu’ils sont utilisés dans Windows. Contrairement à _cprintf, _cwprintf 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.

_cprintf valide le paramètre format. S’il format s’agit d’un pointeur Null, la fonction appelle 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, la fonction retourne -1 et définit errno avec la valeur EINVAL.

Important

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

À compter de Windows 10 version 2004 (build 19041), la famille de fonctions printf imprime exactement les nombres à virgule flottante pouvant être représentés en suivant les règles IEEE 754 pour l’arrondi. Dans les versions précédentes de Windows, les nombres à virgule flottante pouvant être représentés exactement qui se terminent par « 5 » sont toujours arrondis à la valeur supérieure. IEEE 754 indique qu’ils doivent être arrondis au chiffre pair le plus proche (également appelé « arrondi du banquier »). Par exemple, printf("%1.0f", 1.5) et printf("%1.0f", 2.5) doivent être arrondis à 2. Avant, 1.5 aurait été arrondi à 2 et 2.5 à 3. Ce changement affecte uniquement les nombres représentables avec précision. Par exemple, 2.35 (qui, lorsqu’il est représenté en mémoire, est plus proche de 2.35000000000000008) continue d’être arrondi à la valeur supérieure 2.4. L’arrondi effectué par ces fonctions respecte également le mode d’arrondi à virgule flottante défini par fesetround. Avant, l’arrondi choisissait toujours le comportement FE_TONEAREST. Ce changement affecte uniquement les programmes générés à l’aide de Visual Studio 2019 versions 16.2 et ultérieures. Pour utiliser le comportement d’arrondi à virgule flottante héritée, liez avec legacy_stdio_float_rounding.obj.

Mappages de routines de texte générique

Routine Tchar.h	_UNICODE et _MBCS non définis	_MBCS défini	_UNICODE défini
_tcprintf	_cprintf	_cprintf	_cwprintf
_tcprintf_l	_cprintf_l	_cprintf_l	_cwprintf_l

Spécifications

Routine	En-tête requis
_cprintf, _cprintf_l	<conio.h>
_cwprintf, _cwprintf_l	<conio.h>

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

Exemple

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

E/S de console et de port
_cscanf, , _cscanf_l_cwscanf, ,_cwscanf_l
fprintf, , _fprintf_lfwprintf, ,_fwprintf_l
printf, , _printf_lwprintf, ,_wprintf_l
sprintf, , _sprintf_lswprintf, , _swprintf_l__swprintf_l
vfprintf, , _vfprintf_lvfwprintf, ,_vfwprintf_l
_cprintf_s, , _cprintf_s_l_cwprintf_s, ,_cwprintf_s_l
_cprintf_p, , _cprintf_p_l_cwprintf_p, ,_cwprintf_p_l
Syntaxe de spécification de format : printf et wprintf fonctions