CW2WEX, classe
Cette classe est utilisée par les macros de conversion de chaîne CW2TEX et CT2WEX et le typedef CW2W.
Important
Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s’exécutent dans Windows Runtime.
Syntaxe
template <int t_nBufferLength = 128>
class CW2WEX
Paramètres
t_nBufferLength
Taille de la mémoire tampon utilisée dans le processus de traduction. La longueur par défaut est 128 octets.
Membres
Constructeurs publics
| Nom | Description |
|---|---|
| CW2WEX ::CW2WEX | Constructeur . |
| CW2WEX ::~CW2WEX | Destructeur. |
Opérateurs publics
| Nom | Description |
|---|---|
| CW2WEX ::operator LPWSTR | Opérateur de conversion. |
Membres de données publics
| Nom | Description |
|---|---|
| CW2WEX ::m_psz | Membre de données qui stocke la chaîne source. |
| CW2WEX ::m_szBuffer | Mémoire tampon statique utilisée pour stocker la chaîne convertie. |
Notes
Sauf si des fonctionnalités supplémentaires sont requises, utilisez CW2TEX, CT2WEX ou CW2W dans votre code.
Cette classe contient une mémoire tampon statique de taille fixe utilisée pour stocker le résultat de la conversion. Si le résultat est trop volumineux pour s’adapter à la mémoire tampon statique, la classe alloue de la mémoire à l’aide de malloc, ce qui libère la mémoire lorsque l’objet sort de l’étendue. Cela garantit que, contrairement aux macros de conversion de texte disponibles dans les versions précédentes d’ATL, cette classe est sûre à utiliser dans des boucles et qu’elle ne dépasse pas la pile.
Si la classe tente d’allouer de la mémoire sur le tas et échoue, elle appelle AtlThrow avec un argument de E_OUTOFMEMORY.
Par défaut, les classes et macros de conversion ATL utilisent la page de codes ANSI du thread actuel pour la conversion.
Les macros suivantes sont basées sur cette classe :
CW2TEX
CT2WEX
Le typedef suivant est basé sur cette classe :
- CW2W
Pour une discussion sur ces macros de conversion de texte, consultez les macros de conversion de chaîne ATL et MFC.
Exemple
Consultez les macros de conversion de chaîne ATL et MFC pour obtenir un exemple d’utilisation de ces macros de conversion de chaîne.
Spécifications
En-tête : atlconv.h
CW2WEX ::CW2WEX
Constructeur .
CW2WEX(LPCWSTR psz, UINT nCodePage) throw(...);
CW2WEX( LPCWSTR psz) throw(...);
Paramètres
psz
Chaîne de texte à convertir.
nCodePage
Page de codes. Non utilisé dans cette classe.
Notes
Crée la mémoire tampon requise pour la traduction.
CW2WEX ::~CW2WEX
Destructeur..
~CW2WEX() throw();
Notes
Libère la mémoire tampon allouée.
CW2WEX ::m_psz
Membre de données qui stocke la chaîne source.
LPWSTR m_psz;
CW2WEX ::m_szBuffer
Mémoire tampon statique utilisée pour stocker la chaîne convertie.
wchar_t m_szBuffer[t_nBufferLength];
CW2WEX ::operator LPWSTR
Opérateur de cast.
operator LPWSTR() const throw();
Valeur de retour
Retourne la chaîne de texte en tant que type LPWSTR.
Voir aussi
CA2AEX, classe
CA2CAEX, classe
CA2WEX, classe
CW2AEX, classe
CW2CWEX, classe
Vue d’ensemble de la classe