Partager via


_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Formats et imprime sur la console, avec la prise 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 les fenêtres d'exécution.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 format.

  • argument
    Paramètres facultatifs.

  • locale
    Les paramètres régionaux à utiliser.

Valeur de retour

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

Notes

Le format de ces fonctions d'impression et un ensemble de caractères et les valeurs directement dans la console, à l'aide de _putch et _putwch fonctionne pour sortir les caractères.Chaque argument (le cas échéant) est converti et de sortie en fonction de la spécification du format correspondante dans format.Le format a la même forme et fonction de le paramètre d' format pour la fonction d' printf_p .La différence entre _cprintf_p et cprintf_s est qu' _cprintf_p prend en charge les paramètres positionnels, qui 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 de printf_p.

Contrairement à fprintf_p, d' printf_p, et les fonctions d' sprintf_p, ni _cprintf_p ni _cwprintf_p ne convertit les caractères de retour à la ligne en mélanges de la puissance de retour- ligne de chariot (CR-LF) une fois sortie.Une distinction importante est que _cwprintf_p affiche des caractères Unicode en cas de utilisation dans Windows NT.Contrairement à _cprintf_p, _cwprintf_p utilise les paramètres régionaux de console.

Les versions de ces fonctions avec le suffixe d' _l sont identiques sauf qu'elles utilisent le paramètre de paramètres régionaux passé au lieu des paramètres régionaux.

Note de sécurité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 de la chaîne de format.Si format ou argument sont NULL, ou de la chaîne de format contient des caractères de disposition incorrects, ces fonctions appelle le gestionnaire de paramètre non valide, comme décrit dans Validation des paramètres.Si est autorisé à l'exécution pour continuer, ces fonctions retournent -1 et affectez errno à EINVAL.

Mappages de routines de texte générique

Routine de Tchar.h

_UNICODE et non définis _MBCS

_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 de compatibilité, consultez Compatibilité dans l'introduction.

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

Voir aussi

Référence

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

_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l

paramètres positionnels de printf_p

paramètres positionnels de printf_p

Syntaxe de spécification de format : fonctions printf et wprintf