Classe CW2AEX
Questa classe viene usata dalle macro di conversione di stringhe CT2AEX, CW2TEX, CW2CTEXe CT2CAEXe dal typedef CW2A.
Importante
Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.
Sintassi
template<int t_nBufferLength = 128>
class CW2AEX
Parametri
t_nBufferLength
Dimensioni del buffer utilizzato nel processo di conversione. La lunghezza predefinita è di 128 byte.
Membri
Costruttori pubblici
| Nome | Descrizione |
|---|---|
CW2AEX::CW2AEX |
Costruttore. |
CW2AEX::~CW2AEX |
Distruttore. |
Operatori pubblici
| Nome | Descrizione |
|---|---|
| CW2AEX::operator LPSTR | Operatore di conversione. |
Membri dati pubblici
| Nome | Descrizione |
|---|---|
CW2AEX::m_psz |
Membro dati che archivia la stringa di origine. |
CW2AEX::m_szBuffer |
Buffer statico utilizzato per archiviare la stringa convertita. |
Osservazioni:
A meno che non siano necessarie funzionalità aggiuntive, usare CT2AEX, CW2TEX, CW2CTEX, CT2CAEXo CW2A nel codice.
Questa classe contiene un buffer statico a dimensione fissa utilizzato per archiviare il risultato della conversione. Se il risultato è troppo grande per rientrare nel buffer statico, la classe alloca la 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à chiamata 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. Se si vuole eseguire l'override di tale comportamento per una conversione specifica, specificare la tabella codici come secondo parametro per il costruttore per la classe .
Le macro seguenti sono basate su questa classe:
CT2AEXCW2TEXCW2CTEXCT2CAEX
Il typedef seguente si basa su questa classe:
CW2A
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
CW2AEX::CW2AEX
Costruttore.
CW2AEX(LPCWSTR psz, UINT nCodePage) throw(...);
CW2AEX(LPCWSTR psz) throw(...);
Parametri
psz
Stringa di testo da convertire.
nCodePage
Tabella codici utilizzata per eseguire la conversione. Per altri dettagli, vedere la discussione sui parametri della tabella codici per la funzione MultiByteToWideChar di Windows SDK.
Osservazioni:
Alloca il buffer usato nel processo di traduzione.
CW2AEX::~CW2AEX
Distruttore.
~CW2AEX() throw();
Osservazioni:
Libera il buffer allocato.
CW2AEX::m_psz
Membro dati che archivia la stringa di origine.
LPSTR m_psz;
CW2AEX::m_szBuffer
Buffer statico utilizzato per archiviare la stringa convertita.
char m_szBuffer[t_nBufferLength];
CW2AEX::operator LPSTR
Operatore di conversione.
operator LPSTR() const throw();
Valore restituito
Restituisce la stringa di testo come tipo LPSTR.
Vedi anche
CA2AEX Classe
CA2CAEX Classe
CA2WEX Classe
CW2CWEX Classe
CW2WEX Classe
Cenni preliminari sulla classe