Udostępnij za pośrednictwem

Klasa CA2WEX

  • Artykuł

Ta klasa jest używana przez makra konwersji ciągów CA2TEX, CA2CTEX, CT2WEX i CT2CWEX oraz typedef CA2W.

Ważne

Tej klasy i jej składowych nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.

Składnia

template <int t_nBufferLength = 128>
class CA2WEX

Parametry

t_nBufferLength
Rozmiar buforu używanego w procesie tłumaczenia. Domyślna długość to 128 bajtów.

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CA2WEX::CA2WEX Konstruktor.
CA2WEX::~CA2WEX Destruktora.

Operatory publiczne

Nazwa/nazwisko opis
CA2WEX::operator LPWSTR Operator konwersji.

Publiczne elementy członkowskie danych

Nazwa/nazwisko opis
CA2WEX::m_psz Element członkowski danych, który przechowuje ciąg źródłowy.
CA2WEX::m_szBuffer Bufor statyczny używany do przechowywania przekonwertowanego ciągu.

Uwagi

Jeśli nie jest wymagana dodatkowa funkcjonalność, użyj ca2TEX, CA2CTEX, CT2WEX, CT2CWEX lub CA2W w kodzie.

Ta klasa zawiera statyczny bufor o stałym rozmiarze, który jest używany do przechowywania wyniku konwersji. Jeśli wynik jest zbyt duży, aby zmieścić się w buforze statycznym, klasa przydziela pamięć przy użyciu malloc, zwalniając pamięć, gdy obiekt wykracza poza zakres. Dzięki temu, w przeciwieństwie do makr konwersji tekstu dostępnych w poprzednich wersjach atl, ta klasa jest bezpieczna do użycia w pętlach i że nie przepełni stosu.

Jeśli klasa spróbuje przydzielić pamięć na stercie i zakończy się niepowodzeniem, wywoła AtlThrow argument E_OUTOFMEMORY.

Domyślnie klasy konwersji ATL i makra używają strony kodowej ANSI bieżącego wątku do konwersji. Jeśli chcesz zastąpić to zachowanie dla określonej konwersji, określ stronę kodową jako drugi parametr konstruktora dla klasy.

Następujące makra są oparte na tej klasie:

  • CA2TEX

  • CA2CTEX

  • CT2WEX

  • CT2CWEX

Następująca definicja typu jest oparta na tej klasie:

  • CA2W

Aby zapoznać się z omówieniem tych makr konwersji tekstu, zobacz Makra konwersji ciągów ATL i MFC.

Przykład

Zobacz Makra konwersji ciągów ATL i MFC, aby zapoznać się z przykładem użycia tych makr konwersji ciągów.

Wymagania

Nagłówek: atlconv.h

CA2WEX::CA2WEX

Konstruktor.

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

Parametry

psz
Ciąg tekstowy do przekonwertowania.

nCodePage
Strona kodowa używana do przeprowadzenia konwersji. Aby uzyskać więcej informacji, zobacz dyskusję na temat parametrów strony kodowej dla funkcji Zestawu SDK systemu Windows MultiByteToWideChar .

Uwagi

Przydziela bufor używany w procesie tłumaczenia.

CA2WEX::~CA2WEX

Destruktora.

~CA2WEX() throw();

Uwagi

Zwalnia przydzielony bufor.

CA2WEX::m_psz

Element członkowski danych, który przechowuje ciąg źródłowy.

LPWSTR m_psz;

CA2WEX::m_szBuffer

Bufor statyczny używany do przechowywania przekonwertowanego ciągu.

wchar_t m_szBuffer[t_nBufferLength];

CA2WEX::operator LPWSTR

Operator konwersji.

operator LPWSTR() const throw();

Wartość zwracana

Zwraca ciąg tekstowy jako typ LPWSTR.

Zobacz też

Klasa CA2AEX
Klasa CA2CAEX
Klasa CW2AEX
Klasa CW2CWEX
Klasa CW2WEX
Omówienie klasy