Prototype
static char* EDivers::StringUnicodeToStringAsciiConvert( wchar_t *pszStringUnicode );

Cette fonction convertit la chaîne de caractères pszStringUnicode, qui est au format Unicode, en chaîne de caractères au format Ascii.

La fonction alloue, en interne, suffisemment de mémoire pour pouvoir effectuer la conversion. Puis elle retourne le pointeur contenant la chaîne de caractères au format Ascii.

Si la chaîne de caractères pszStringUnicode est NULL, la fonction la considère comme une chaîne de caractères Unicode vide L"" (soit 0x00 et 0x00) et donc retournera la chaîne de caractères Ascii vide "" (soit 0x00).

Attention, le pointeur retourné doit être libéré, par votre propre soin, lorsque l'on en a plus l'utilité par la fonction standard free (si le pointeur retourné est différent de NULL, bien sûr).

 

Argument

wchar_t *pszStringUnicode

adresse de la chaîne de caractères au format Unicode à convertir.

 

Retour

char*

pointeur de type char contenant la chaîne de caractères au format Ascii.

Ce pointeur peut être NULL si la fonction a échouée dans la conversion.

 

Exemple

Description :

Conversion de la chaîne de caractères au format Unicode contenant les données 0x4D, 0x00, 0x78, 0x00, 0x20, 0x00, 0x74, 0x00, 0x65, 0x00, 0x78, 0x00, 0x74, 0x00, 0x00 et 0x00 ("My text" en UNICODE) en une chaîne de caractères au format Ascii.

Chacune des données de la chaîne de caractères au format Ascii est affichée dans la fenêtre de sortie de debugage.

Code :

wchar_t *pszStringUnicode = L"My text";
char *pszStringAscii = EDivers::StringUnicodeToStringAsciiConvert( pszStringUnicode );

if ( pszStringAscii )
  {
  ulonglong ullStringSize = strlen( pszStringAscii ) + 1;
  uchar *puc = (uchar*)pszStringAscii;
  ulonglong ullCpt;

  for ( ullCpt=0; ullCpt<ullStringSize; ullCpt++ )
    {
    ETrace::DoExA( "Byte #%I64u = 0x%02X ('%c').\n", ullCpt, *puc, (*puc > 31) ? *puc : ' ' );
    puc++;
    }

  // Ne pas oublier de libérer le pointeur renvoyé
  // par la fonction "EDivers::StringUnicodeToStringAsciiConvert"
  free( pszStringAscii );
  }

Sortie :

Byte #0 = 0x4D ('M').
Byte #1 = 0x79 ('y').
Byte #2 = 0x20 (' ').
Byte #3 = 0x74 ('t').
Byte #4 = 0x65 ('e').
Byte #5 = 0x78 ('x').
Byte #6 = 0x74 ('t').
Byte #7 = 0x00 (' ').

Vue :

Vue de la chaîne de caractères pszStringUnicode au format Unicode :

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E FF
00 01 02 03 04 05 06 07 08 09 0A 0B
4D
M		 00
 79
y		 00
 20
 00
 74
t		 00
 65
e		 00
 78
x		 00
10 11 12 13 14 15 16 17 18 19 1A 1B 1C 1D 1E ..
0C 0D 0E 0F
74
t		 00
 00
 00

Vue de la chaîne de caractères pszStringAscii au format Ascii :

00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E ..
00 01 02 03 04 05 06 07
4D
M		 79
y		 20
 74
t		 65
e		 78
x		 74
t		 00

 

 

Voir aussi
static wchar_t* EDivers::StringAsciiToStringUnicodeConvert( char *pszStringAscii );

 

Minimum
Version 1.0.0