Clase CA2AEX

Esta clase se usa en las macros de conversión de cadenas CA2TEX y CT2AEX y en la definición de tipo CA2A.

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 CA2AEX

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

Operadores públicos

Nombre	Descripción
CA2AEX::operator LPSTR	Operador de conversión.

Miembros de datos públicos

Nombre	Descripción
CA2AEX::m_psz	Miembro de datos que almacena la cadena de origen.
CA2AEX::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 CA2TEX, CT2AEX o CA2A en el código propio.

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:

• CA2TEX

• CT2AEX

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

• CA2A

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

CA2AEX::CA2AEX

Constructor .

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

Parámetros

psz
La cadena de texto que se va a convertir.

nCodePage
No se usa en esta clase.

Comentarios

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

CA2AEX::~CA2AEX

El destructor .

~CA2AEX() throw();

Comentarios

Libera el búfer asignado.

CA2AEX::m_psz

Miembro de datos que almacena la cadena de origen.

LPSTR m_psz;

CA2AEX::m_szBuffer

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

char m_szBuffer[ t_nBufferLength];

CA2AEX::operator LPSTR

Operador de conversión.

operator LPSTR() const throw();

Valor devuelto

Devuelve la cadena de texto como tipo LPSTR.

Consulte también

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