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