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
Název | Popis |
---|---|
CA2WEX::CA2WEX | Konstruktor |
CA2WEX::~CA2WEX | Destruktor. |
Veřejné operátory
Název | Popis |
---|---|
CA2WEX::operator LPWSTR | Operátor převodu. |
Veřejné datové členy
Název | 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();
Návratová 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