_cprintf_p, _cprintf_p_l, _cwprintf_p, _cwprintf_p_l

Article
03/15/2013

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