_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.
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_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_p
combinaisons , printf_p
et 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
.
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 printf
famille de fonctions imprime exactement des nombres à virgule flottante pouvant être représentés en fonction des règles IEEE 754 pour l’arrondi. Dans les versions précédentes de Windows, les nombres à virgule flottante qui se terminent exactement par « 5 » sont toujours arrondis. IEEE 754 indique qu’ils doivent arrondir au chiffre pair le plus proche (également appelé « Arrondi du banquier »). Par exemple, les deux printf("%1.0f", 1.5)
et printf("%1.0f", 2.5)
doivent arrondir à 2. Auparavant, 1,5 arrondirait à 2 et 2,5 arrondirait à 3. Cette modification affecte uniquement les nombres représentant exactement. Par exemple, la version 2.35 (qui, lorsqu’elle est représentée en mémoire, est plus proche de 2,350000000000008) continue d’arrondir jusqu’à 2,4. L’arrondi effectué par ces fonctions respecte désormais également le mode d’arrondi à virgule flottante défini par fesetround
. Auparavant, l’arrondi a toujours choisi FE_TONEAREST
le comportement. Cette modification affecte uniquement les programmes générés à l’aide de Visual Studio 2019 version 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 routine de texte générique
Routine Tchar.h | _UNICODE et _MBCS non défini |
_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 |
Spécifications
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 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_l
, fwprintf_s
, _fwprintf_s_l
_printf_p
, _printf_p_l
, _wprintf_p
, _wprintf_p_l
printf_s
, _printf_s_l
, wprintf_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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour