Clase CW2WEX

Esta clase la usan las macros de conversión de cadenas CT2WEX, CW2TEX y la definición de tipo CW2W.

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 CW2WEX

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
CW2WEX::CW2WEX	Constructor .
CW2WEX::~CW2WEX	El destructor .

Operadores públicos

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

Miembros de datos públicos

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

Comentarios

A menos que se requiera una funcionalidad adicional, use CW2TEX, CT2WEX o CW2W 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.

Las siguientes macros se basan en esta clase:

• CW2TEX

• CT2WEX

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

• CW2W

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

CW2WEX::CW2WEX

Constructor .

CW2WEX(LPCWSTR psz, UINT nCodePage) throw(...);
CW2WEX( LPCWSTR  psz) throw(...);

Parámetros

psz
La cadena de texto que se va a convertir.

nCodePage
La página de códigos. No se usa en esta clase.

Comentarios

Crea el búfer necesario para la traducción.

CW2WEX::~CW2WEX

El destructor.

~CW2WEX() throw();

Comentarios

Libera el búfer asignado.

CW2WEX::m_psz

Miembro de datos que almacena la cadena de origen.

LPWSTR m_psz;

CW2WEX::m_szBuffer

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

wchar_t m_szBuffer[t_nBufferLength];

CW2WEX::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)
CA2WEX (clase)
CW2AEX (clase)
CW2CWEX (clase)
Información general sobre la clase