Classe CW2WEX

Questa classe viene utilizzata dalle macro di conversione di stringhe CW2TEX e CT2WEX e dal typedef CW2W.

Importante

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

Sintassi

template <int t_nBufferLength = 128>
class CW2WEX

Parametri

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

Membri

Costruttori pubblici

Nome Descrizione
CW2WEX::CW2WEX Costruttore.
CW2WEX::~CW2WEX Distruttore.

Operatori pubblici

Nome Descrizione
CW2WEX::operator LPWSTR Operatore di conversione.

Membri dati pubblici

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

Osservazioni:

A meno che non siano necessarie funzionalità aggiuntive, usare CW2TEX, CT2WEX o CW2W nel 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:

  • CW2TEX

  • CT2WEX

Il typedef seguente si basa su questa classe:

  • CW2W

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

CW2WEX::CW2WEX

Costruttore.

CW2WEX(LPCWSTR psz, UINT nCodePage) throw(...);
CW2WEX( LPCWSTR  psz) throw(...);

Parametri

psz
Stringa di testo da convertire.

nCodePage
Tabella codici. Non usato in questa classe.

Osservazioni:

Crea il buffer necessario per la traduzione.

CW2WEX::~CW2WEX

Distruttore..

~CW2WEX() throw();

Osservazioni:

Libera il buffer allocato.

CW2WEX::m_psz

Membro dati che archivia la stringa di origine.

LPWSTR m_psz;

CW2WEX::m_szBuffer

Buffer statico utilizzato per archiviare la stringa convertita.

wchar_t m_szBuffer[t_nBufferLength];

CW2WEX::operator LPWSTR

Operatore Cast.

operator LPWSTR() const throw();

Valore restituito

Restituisce la stringa di testo come tipo LPWSTR.

Vedi anche

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