Dela via

CW2WEX-klass

  • Artikel

Den här klassen används av strängkonverteringsmakronen CW2TEX och CT2WEX och typedef CW2W.

Viktig

Den här klassen och dess medlemmar kan inte användas i program som körs i Windows Runtime.

Syntax

template <int t_nBufferLength = 128>
class CW2WEX

Parametrar

t_nBufferLength
Storleken på bufferten som används i översättningsprocessen. Standardlängden är 128 byte.

Medlemmar

Offentliga konstruktorer

Namn Beskrivning
CW2WEX::CW2WEX Konstruktorn.
CW2WEX::~CW2WEX Destructor.

Offentliga operatörer

Namn Beskrivning
CW2WEX::operator LPWSTR Konverteringsoperator.

Medlemmar i offentliga data

Namn Beskrivning
CW2WEX::m_psz Den datamedlem som lagrar källsträngen.
CW2WEX::m_szBuffer Den statiska bufferten som används för att lagra den konverterade strängen.

Anmärkningar

Om inte extra funktioner krävs använder du CW2TEX, CT2WEX eller CW2W i koden.

Den här klassen innehåller en statisk buffert med fast storlek som används för att lagra resultatet av konverteringen. Om resultatet är för stort för att passa in i den statiska bufferten allokerar klassen minne med hjälp av malloc, vilket frigör minnet när objektet hamnar utanför omfånget. Detta säkerställer att den här klassen, till skillnad från textkonverteringsmakron som är tillgängliga i tidigare versioner av ATL, är säker att använda i loopar och att den inte spiller över stacken.

Om klassen försöker allokera minne på heapen och misslyckas anropas AtlThrow med argumentet E_OUTOFMEMORY.

Som standard använder ATL-konverteringsklasserna och makrona den aktuella trådens ANSI-kodsida för konverteringen.

Följande makron baseras på den här klassen:

  • CW2TEX

  • CT2WEX

Följande typedef baseras på den här klassen:

  • CW2W

En diskussion om dessa textkonverteringsmakron finns i ATL- och MFC-strängkonverteringsmakron.

Exempel

Se ATL- och MFC-strängkonverteringsmakron ett exempel på hur du använder dessa strängkonverteringsmakron.

Krav

rubrik: atlconv.h

CW2WEX::CW2WEX

Konstruktorn.

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

Parametrar

psz
Textsträngen som ska konverteras.

nCodePage-
Kodsidan. Används inte i den här klassen.

Anmärkningar

Skapar bufferten som krävs för översättningen.

CW2WEX::~CW2WEX

Destructor.

~CW2WEX() throw();

Anmärkningar

Frigör den allokerade bufferten.

CW2WEX::m_psz

Den datamedlem som lagrar källsträngen.

LPWSTR m_psz;

CW2WEX::m_szBuffer

Den statiska bufferten som används för att lagra den konverterade strängen.

wchar_t m_szBuffer[t_nBufferLength];

CW2WEX::operator LPWSTR

Gjutningsoperator.

operator LPWSTR() const throw();

Returvärde

Returnerar textsträngen som typ LPWSTR.

Se även

CA2AEX-klass
CA2CAEX klass
CA2WEX-klass
CW2AEX-klass
CW2CWEX klass
översikt över -klass