Udostępnij za pośrednictwem

Klasa CA2AEX

  • Artykuł

Ta klasa jest używana przez makra konwersji ciągów CA2TEX i CT2AEX oraz typedef CA2A.

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 CA2AEX

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

Operatory publiczne

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

Publiczne elementy członkowskie danych

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

Uwagi

Jeśli nie jest wymagana dodatkowa funkcjonalność, należy użyć funkcji CA2TEX, CT2AEX lub CA2A we własnym 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:

  • CA2TEX

  • CT2AEX

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

  • CA2A

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

CA2AEX::CA2AEX

Konstruktor.

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

Parametry

psz
Ciąg tekstowy do przekonwertowania.

nCodePage
Nieużywane w tej klasie.

Uwagi

Tworzy bufor wymagany do tłumaczenia.

CA2AEX::~CA2AEX

Destruktora.

~CA2AEX() throw();

Uwagi

Zwalnia przydzielony bufor.

CA2AEX::m_psz

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

LPSTR m_psz;

CA2AEX::m_szBuffer

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

char m_szBuffer[ t_nBufferLength];

CA2AEX::operator LPSTR

Operator konwersji.

operator LPSTR() const throw();

Wartość zwracana

Zwraca ciąg tekstowy jako typ LPSTR.

Zobacz też

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