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