Compartir a través de

Clase CA2WEX

  • Artículo

Esta clase la usan las macros de conversión de cadenas CA2TEX, CA2CTEX, CT2WEX y CT2CWEX, y la definición de tipo CA2W.

Importante

Esta clase y sus miembros no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.

Sintaxis

template <int t_nBufferLength = 128>
class CA2WEX

Parámetros

t_nBufferLength
El tamaño del búfer usado en el proceso de traducción. La longitud predeterminada es de 128 bytes.

Miembros

Constructores públicos

Nombre Descripción
CA2WEX::CA2WEX Constructor .
CA2WEX::~CA2WEX El destructor .

Operadores públicos

Nombre Descripción
CA2WEX::operator LPWSTR Operador de conversión.

Miembros de datos públicos

Nombre Descripción
CA2WEX::m_psz Miembro de datos que almacena la cadena de origen.
CA2WEX::m_szBuffer El búfer estático que se usa para almacenar la cadena convertida.

Comentarios

A menos que se requiera funcionalidad adicional, use CA2TEX, CA2CTEX, CT2WEX, CT2CWEX o CA2W en el código.

Esta clase contiene un búfer estático de tamaño fijo que se usa para almacenar el resultado de la conversión. Si el resultado es demasiado grande para ajustarse al búfer estático, la clase asigna memoria a través de malloc, y libera la memoria cuando el objeto sale del ámbito. Esto garantiza que, a diferencia de las macros de conversión de texto disponibles en versiones anteriores de ATL, esta clase es segura para usar en bucles y que no desborde la pila.

Si la clase intenta asignar memoria en el montón y produce un error, llamará a AtlThrow con un argumento de E_OUTOFMEMORY.

Las macros y clases de conversión de ATL usarán de forma predeterminada la página de códigos ANSI del subproceso actual para la conversión. Si desea invalidar este comportamiento en una conversión concreta, indique la página de código como segundo parámetro del constructor de la clase.

Las siguientes macros se basan en esta clase:

  • CA2TEX

  • CA2CTEX

  • CT2WEX

  • CT2CWEX

La siguiente definición de tipo se basa en esta clase:

  • CA2W

Para obtener una explicación de estas macros de conversión de texto, vea Macros de conversión de cadenas ATL y MFC.

Ejemplo

Consulte Macros de conversión de cadenas ATL y MFC para ver un ejemplo de uso de estas macros de conversión de cadena.

Requisitos

Encabezado: atlconv.h

CA2WEX::CA2WEX

Constructor .

CA2WEX(LPCSTR psz, UINT nCodePage) throw(...);
CA2WEX(LPCSTR psz) throw(...);

Parámetros

psz
La cadena de texto que se va a convertir.

nCodePage
Página de códigos que se usa para realizar la conversión. Consulte la explicación de parámetros de la página de códigos para la función MultiByteToWideChar de Windows SDK para obtener más detalles.

Comentarios

Asigna el búfer usado en el proceso de traducción.

CA2WEX::~CA2WEX

El destructor .

~CA2WEX() throw();

Comentarios

Libera el búfer asignado.

CA2WEX::m_psz

Miembro de datos que almacena la cadena de origen.

LPWSTR m_psz;

CA2WEX::m_szBuffer

El búfer estático que se usa para almacenar la cadena convertida.

wchar_t m_szBuffer[t_nBufferLength];

CA2WEX::operator LPWSTR

Operador de conversión.

operator LPWSTR() const throw();

Valor devuelto

Devuelve la cadena de texto como tipo LPWSTR.

Consulte también

CA2AEX (clase)
CA2CAEX (clase)
CW2AEX (clase)
CW2CWEX (clase)
CW2WEX (clase)
Información general sobre la clase