CA2WEX – třída

Tuto třídu používají makra převodu řetězců CA2TEX, CA2CTEX, CT2WEX a CT2CWEX a typedef CA2W.

Důležité

Tuto třídu a její členy nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.

Syntaxe

template <int t_nBufferLength = 128>
class CA2WEX

Parametry

t_nBufferLength
Velikost vyrovnávací paměti použité v procesu překladu. Výchozí délka je 128 bajtů.

Členové

Veřejné konstruktory

Jméno	popis
CA2WEX::CA2WEX	Konstruktor
CA2WEX::~CA2WEX	Destruktor.

Veřejné operátory

Jméno	popis
CA2WEX::operator LPWSTR	Operátor převodu.

Veřejné datové členy

Jméno	popis
CA2WEX::m_psz	Datový člen, který ukládá zdrojový řetězec.
CA2WEX::m_szBuffer	Statická vyrovnávací paměť použitá k uložení převedeného řetězce.

Poznámky

Pokud není vyžadována další funkce, ve svém kódu použijte CA2TEX, CA2CTEX, CT2WEX, CT2CWEX nebo CA2W.

Tato třída obsahuje statickou vyrovnávací paměť s pevnou velikostí, která slouží k uložení výsledku převodu. Pokud je výsledek příliš velký, aby se vešl do statické vyrovnávací paměti, třída přidělí paměť pomocí malloc a uvolní paměť, když objekt přejde mimo rozsah. Tím se zajistí, že na rozdíl od maker převodu textu dostupných v předchozích verzích ATL je tato třída bezpečná pro použití ve smyčce a že zásobník nepřeteče.

Pokud se třída pokusí přidělit paměť haldy a selže, zavolá AtlThrow s argumentem E_OUTOFMEMORY.

Ve výchozím nastavení třídy převodu ATL a makra používají pro převod znakovou stránku ANSI aktuálního vlákna. Pokud chcete toto chování přepsat pro konkrétní převod, zadejte znakovou stránku jako druhý parametr konstruktoru pro třídu.

Následující makra jsou založená na této třídě:

• CA2TEX

• CA2CTEX

• CT2WEX

• CT2CWEX

Následující typedef je založen na této třídě:

• CA2W

Diskuzi o těchto makrech pro převod textu naleznete v tématu ATL a MFC String Conversion Macros.

Příklad

Příklad použití těchto maker pro převod řetězců najdete v tématech ATL a MFC String Conversion Macros.

Požadavky

Hlavička: atlconv.h

CA2WEX::CA2WEX

Konstruktor

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

Parametry

psz
Textový řetězec, který se má převést.

nCodePage
Znaková stránka použitá k provedení převodu. Další podrobnosti najdete v diskuzi o parametrech znakové stránky pro funkci MultiByteToWideChar sady Windows SDK.

Poznámky

Přidělí vyrovnávací paměť použitou v procesu překladu.

CA2WEX::~CA2WEX

Destruktor.

~CA2WEX() throw();

Poznámky

Uvolní přidělenou vyrovnávací paměť.

CA2WEX::m_psz

Datový člen, který ukládá zdrojový řetězec.

LPWSTR m_psz;

CA2WEX::m_szBuffer

Statická vyrovnávací paměť použitá k uložení převedeného řetězce.

wchar_t m_szBuffer[t_nBufferLength];

CA2WEX::operator LPWSTR

Operátor převodu.

operator LPWSTR() const throw();

Vrácená hodnota

Vrátí textový řetězec jako typ LPWSTR.

Viz také

CA2AEX – třída
CA2CAEX – třída
CW2AEX – třída
CW2CWEX – třída
CW2WEX – třída
Přehled třídy