CA2WEX, classe

Article
06/09/2015

Cette classe est utilisée par les macros de conversion de chaînes CA2TEX, CA2CTEX, CT2WEX, et CT2CWEX, et le typedef CA2W.

Important

Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s'exécutent dans les fenêtres d'exécution.

template< 
int t_nBufferLength= 128 
> 
class CA2WEX

Paramètres

t_nBufferLength
La taille de la mémoire tampon utilisée dans le processus de traduction. La longueur par défaut est de 128 octets.

Membres

Constructeurs publics

Nom	Description
CA2WEX::CA2WEX	Constructeur.
CA2WEX::~CA2WEX	Le destructeur.

Opérateurs publics

Nom	Description
CA2WEX::operator LPWSTR	Opérateur de conversion.

Données membres publiques

Nom	Description
CA2WEX::m_psz	La donnée membre qui stocke la chaîne source.
CA2WEX::m_szBuffer	Le tampon statique, utilisé pour stocker la chaîne convertie.

Notes

À moins que la fonctionnalité supplémentaire est requise, utilisez CA2TEX, CA2CTEX, CT2WEX, CT2CWEX, ou CA2W dans votre code.

Cette classe contient un tampon statique de taille fixe qui est utilisé pour stocker le résultat de la conversion. Si le résultat est trop grand pour s'insérer dans la mémoire tampon statique, la classe alloue de la mémoire à malloc, libération de la mémoire lorsque l'objet est hors de portée. Cela garantit que, contrairement aux macros de conversion de texte disponibles dans les versions antérieures ATL, il est sécurisée utiliser cette classe dans les boucles et qu'il ne débordera pas la pile.

Si les tests de la classe pour allouer de la mémoire sur le tas et de échec, il appellera AtlThrow avec un argument d' E_OUTOFMEMORY.

Par défaut, les classes de conversion ATL et les macros utilisent la page de codes ANSI du thread actuel de la conversion. Si vous souhaitez substituer ce comportement pour une conversion spécifique, spécifiez la page de codes comme second paramètre au constructeur de la classe.

Les macros suivantes sont basés sur cette classe :