CW2AEX Klasa

  • Artykuł

Ta klasa jest używana przez makra konwersji ciągów CT2AEX, CW2TEX, CW2CTEXi CT2CAEX, i typedef CW2A.

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 CW2AEX

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
CW2AEX::CW2AEX Konstruktor.
CW2AEX::~CW2AEX Destruktora.

Operatory publiczne

Nazwa/nazwisko opis
CW2AEX::operator LPSTR Operator konwersji.

Publiczne elementy członkowskie danych

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

Uwagi

Jeśli nie jest wymagana dodatkowa funkcjonalność, użyj CT2AEXpolecenia , CW2TEX, CW2CTEX, CT2CAEXlub CW2A 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 metody 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 z argumentem 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:

  • CT2AEX

  • CW2TEX

  • CW2CTEX

  • CT2CAEX

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

  • CW2A

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

CW2AEX::CW2AEX

Konstruktor.

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

Parametry

psz
Ciąg tekstowy do przekonwertowania.

nCodePage
Strona kodowa używana do przeprowadzenia konwersji. Aby uzyskać więcej informacji, zobacz omówienie parametrów strony kodowej dla funkcji MultiByteToWideChar zestawu Windows SDK.

Uwagi

Przydziela bufor używany w procesie tłumaczenia.

CW2AEX::~CW2AEX

Destruktora.

~CW2AEX() throw();

Uwagi

Zwalnia przydzielony bufor.

CW2AEX::m_psz

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

LPSTR m_psz;

CW2AEX::m_szBuffer

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

char m_szBuffer[t_nBufferLength];

CW2AEX::operator LPSTR

Operator konwersji.

operator LPSTR() const throw();

Wartość zwracana

Zwraca ciąg tekstowy jako typ LPSTR.

Zobacz też

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