Classe CA2AEX

Questa classe viene usata dalle macro di conversione di stringhe CA2TEX e CT2AEX e ca2A typedef.

Importante

Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.

Sintassi

template <int t_nBufferLength = 128>
class CA2AEX

Parametri

t_nBufferLength
Dimensioni del buffer utilizzato nel processo di conversione. La lunghezza predefinita è di 128 byte.

Membri

Costruttori pubblici

Nome	Descrizione
CA2AEX::CA2AEX	Costruttore.
CA2AEX::~CA2AEX	Distruttore.

Operatori pubblici

Nome	Descrizione
CA2AEX::operator LPSTR	Operatore di conversione.

Membri dati pubblici

Nome	Descrizione
CA2AEX::m_psz	Membro dati che archivia la stringa di origine.
CA2AEX::m_szBuffer	Buffer statico utilizzato per archiviare la stringa convertita.

Osservazioni:

A meno che non siano necessarie funzionalità aggiuntive, usare CA2TEX, CT2AEX o CA2A nel proprio codice.

Questa classe contiene un buffer statico a dimensione fissa che viene usato per archiviare il risultato della conversione. Se il risultato è troppo grande per rientrare nel buffer statico, la classe alloca memoria usando malloc, liberando la memoria quando l'oggetto esce dall'ambito. Ciò garantisce che, a differenza delle macro di conversione del testo disponibili nelle versioni precedenti di ATL, questa classe è sicura da usare nei cicli e che non eseguirà l'overflow dello stack.

Se la classe tenta di allocare memoria nell'heap e non riesce, verrà chiamato AtlThrow con un argomento di E_OUTOFMEMORY.

Per impostazione predefinita, le classi e le macro di conversione ATL usano la tabella codici ANSI del thread corrente per la conversione.

Le macro seguenti sono basate su questa classe:

• CA2TEX

• CT2AEX

Il typedef seguente si basa su questa classe:

• CA2A

Per una descrizione di queste macro di conversione di testo, vedere Macro di conversione di stringhe ATL e MFC.

Esempio

Per un esempio di utilizzo di queste macro di conversione di stringhe, vedere Macro di conversione di stringhe ATL e MFC.

Requisiti

Intestazione: atlconv.h

CA2AEX::CA2AEX

Costruttore.

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

Parametri

Psz
Stringa di testo da convertire.

nCodePage
Inutilizzato in questa classe.

Osservazioni:

Crea il buffer necessario per la traduzione.

CA2AEX::~CA2AEX

Distruttore.

~CA2AEX() throw();

Osservazioni:

Libera il buffer allocato.

CA2AEX::m_psz

Membro dati che archivia la stringa di origine.

LPSTR m_psz;

CA2AEX::m_szBuffer

Buffer statico utilizzato per archiviare la stringa convertita.

char m_szBuffer[ t_nBufferLength];

CA2AEX::operator LPSTR

Operatore di conversione.

operator LPSTR() const throw();

Valore restituito

Restituisce la stringa di testo come tipo LPSTR.

Vedi anche

Classe CA2CAEX
Classe CA2WEX
Classe CW2AEX
Classe CW2CWEX
Classe CW2WEX
Cenni preliminari sulla classe