Udostępnij za pośrednictwem

Klasa CW2WEX

  • Artykuł

Ta klasa jest używana przez makra konwersji ciągów CW2TEX i CT2WEX oraz typedef CW2W.

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 CW2WEX

Parametry

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

Członkowie

Konstruktory publiczne

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

Operatory publiczne

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

Publiczne elementy członkowskie danych

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

Uwagi

Jeśli nie jest wymagana dodatkowa funkcjonalność, użyj CW2TEX, CT2WEX lub CW2W 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.

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

  • CW2TEX

  • CT2WEX

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

  • CW2W

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

CW2WEX::CW2WEX

Konstruktor.

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

Parametry

Psz
Ciąg tekstowy do przekonwertowania.

nCodePage
Strona kodowa. Nie jest używany w tej klasie.

Uwagi

Tworzy bufor wymagany do tłumaczenia.

CW2WEX::~CW2WEX

Destruktor..

~CW2WEX() throw();

Uwagi

Zwalnia przydzielony bufor.

CW2WEX::m_psz

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

LPWSTR m_psz;

CW2WEX::m_szBuffer

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

wchar_t m_szBuffer[t_nBufferLength];

CW2WEX::operator LPWSTR

Operator rzutowania.

operator LPWSTR() const throw();

Wartość zwracana

Zwraca ciąg tekstowy jako typ LPWSTR.

Zobacz też

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