Prototype
static wchar_t* EDivers::StringAsciiToStringUnicodeConvert( char *pszStringAscii );

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

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 Unicode.

Si la chaîne de caractères pszStringAscii est NULL, la fonction la considère comme une chaîne de caractères Ascii vide "" (soit 0x00) et donc retournera la chaîne de caractères Unicode vide L"" (soit 0x00 et 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

char *pszStringAscii

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

 

Retour

wchar_t*

pointeur de type wchar_t contenant la chaîne de caractères au format Unicode.

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 Ascii contenant les données 0x4D, 0x78, 0x20, 0x74, 0x65, 0x78, 0x74 et 0x00 ("My text" en ASCII) en une chaîne de caractères au format Unicode.

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

Code :

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

if ( pszStringUnicode )
  {
  ulonglong ullStringSize = ( wcslen( pszStringUnicode ) + 1 ) * 2;
  uchar *puc = (uchar*)pszStringUnicode;
  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::StringAsciiToStringUnicodeConvert"
  free( pszStringUnicode );
  }

Sortie :

Byte #0 = 0x4D ('M').
Byte #1 = 0x00 (' ').
Byte #2 = 0x79 ('y').
Byte #3 = 0x00 (' ').
Byte #4 = 0x20 (' ').
Byte #5 = 0x00 (' ').
Byte #6 = 0x74 ('t').
Byte #7 = 0x00 (' ').
Byte #8 = 0x65 ('e').
Byte #9 = 0x00 (' ').
Byte #10 = 0x78 ('x').
Byte #11 = 0x00 (' ').
Byte #12 = 0x74 ('t').
Byte #13 = 0x00 (' ').
Byte #14 = 0x00 (' ').
Byte #15 = 0x00 (' ').

Vue :

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

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

 

Voir aussi
static char* EDivers::StringUnicodeToStringAsciiConvert( wchar_t *pszStringUnicode );

 

Minimum
Version 1.0.0