Prototype
static void ETrace::DoEx( char *pszFormat,
... );
ou
static void ETrace::DoEx( wchar_t *pszFormat,
... );

Ces fonctions répercutent le formatage de la chaîne de caractères pszFormat (qui est soit au format Ascii soit Unicode) à l'aide des arguments libres dans la fenêtre de sortie.

La première fonction surchargée est pour le format Ascii, la seconde pour le format Unicode.

Ces deux fonctions ne sont pas accessibles simultanément. En effet, si votre projet est au format Ascii seule la première fonction est utilisable DoEx( char *pszFormat, ... );, mais si votre projet est au format Unicode alors c'est uniquement la seconde fonction qui est utilisable DoEx( wchar_t *pszFormat, ... );.

Attention, les arguments libres de type chaînes de caractères doivent tous être au même format sinon il en résulte une incompatibilité donnant des affichages inattendus dans la fenêtre de sortie.

Conseil : il est judicieux d'englober la chaîne de caractères par la séquence _T(...) (voir la documentation de Visual Studio pour plus de détails). Cette séquence permet de spécifier la nature d'un texte renfermé suivant le mode Ascii/Unicode du projet. Lorsque le projet est en mode Ascii, la chaîne de caractères renfermée par ce mot clé est déclarée comme char, par contre si le projet est en mode Unicode, la chaîne de caractères renfermée par ce mot clé est déclarée comme wchar_t.

La combinaison de l'utilisation de l'une de ces fonctions avec la séquence _T(...) permet de compiler le programme indépendamment du mode Ascii ou Unicode.

 

Argument

char *pszFormat
wchar_t *pszFormat

chaîne de caractères (au format Ascii ou Unicode) servant de canevas de formatage à afficher dans la fenêtre de sortie.

...

succession d'argument(s) libre(s) à utiliser pour formater la chaîne de caractères pszFormat.

 

Retour

Aucun.

 

Exemple

Description :

Affichage d'un texte formaté au format Ascii ou Unicode dans la fenêtre de sortie.

Code :

ETrace::DoEx( _T("Chiffre '%d', lettre '%c', chaîne '%s'.\n"), 4096, 0x41, _T("Ma chaîne") );

Sortie :

Chiffre '4096', lettre 'A', chaîne 'Ma chaîne'.

 

Voir aussi
static void ETrace::DoA( char *pszText );
static void ETrace::DoW( wchar_t *pszText );
static void ETrace::Do( char *pszText );
static void ETrace::Do( wchar_t *pszText );

static void ETrace::DoExA( char *pszFormat, ... );
static void ETrace::DoExW( wchar_t *pszFormat, ... );

 

Minimum
Version 1.0.0