CA2WEX-klasse

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Deze klasse wordt gebruikt door de tekenreeksconversiemacro's CA2TEX, CA2CTEX, CT2WEX en CT2CWEX en de typedef CA2W.

Belangrijk

Deze klasse en de bijbehorende leden kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

Syntaxis

template <int t_nBufferLength = 128>
class CA2WEX

Parameterwaarden

t_nBufferLength
De grootte van de buffer die in het vertaalproces wordt gebruikt. De standaardlengte is 128 bytes.

Leden

Openbare constructors

Naam	Description
CA2WEX::CA2WEX	De constructor.
CA2WEX::~CA2WEX	De destructor.

Openbare operators

Naam	Description
CA2WEX::operator LPWSTR	Conversieoperator.

Publieke dataleden

Naam	Description
CA2WEX::m_psz	Het gegevenslid waarin de brontekenreeks wordt opgeslagen.
CA2WEX::m_szBuffer	De statische buffer, die wordt gebruikt om de geconverteerde tekenreeks op te slaan.

Opmerkingen

Tenzij extra functionaliteit is vereist, gebruikt u CA2TEX, CA2CTEX, CT2WEX, CT2CWEX of CA2W in uw code.

Deze klasse bevat een statische buffer met vaste grootte die wordt gebruikt om het resultaat van de conversie op te slaan. Als het resultaat te groot is om in de statische buffer te passen, wijst de klasse geheugen toe met malloc, waardoor het geheugen vrij komt wanneer het object buiten het bereik valt. Dit zorgt ervoor dat, in tegenstelling tot tekstconversiemacro's die beschikbaar zijn in eerdere versies van ATL, deze klasse veilig is voor gebruik in lussen en dat deze de stack niet overloopt.

Als de klasse probeert geheugen toe te wijzen aan de heap en mislukt, wordt het aangeroepen AtlThrow met een argument van E_OUTOFMEMORY.

Standaard gebruiken de ATL-conversieklassen en -macro's de ANSI-codepagina van de huidige thread voor de conversie. Als u dat gedrag voor een specifieke conversie wilt overschrijven, geeft u de codepagina op als de tweede parameter voor de constructor voor de klasse.

De volgende macro's zijn gebaseerd op deze klasse:

• CA2TEX

• CA2CTEX

• CT2WEX

• CT2CWEX

De volgende typedef is gebaseerd op deze klasse:

• CA2W

Zie ATL- en MFC-tekenreeksconversiemacro's voor een bespreking van deze tekstconversiemacro's.

Example

Zie ATL- en MFC-tekenreeksconversiemacro's voor een voorbeeld van het gebruik van deze tekenreeksconversiemacro's.

Requirements

Koptekst: atlconv.h

CA2WEX::CA2WEX

De constructor.

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

Parameterwaarden

psz
De tekenreeks die moet worden geconverteerd.

nCodePage
De codepagina die wordt gebruikt om de conversie uit te voeren. Zie de parameterdiscussie van de codepagina voor de Windows SDK-functie MultiByteToWideChar voor meer informatie.

Opmerkingen

Hiermee wijst u de buffer toe die in het vertaalproces wordt gebruikt.

CA2WEX::~CA2WEX

De destructor.

~CA2WEX() throw();

Opmerkingen

Hiermee wordt de toegewezen buffer vrijgemaakt.

CA2WEX::m_psz

Het gegevenslid waarin de brontekenreeks wordt opgeslagen.

LPWSTR m_psz;

CA2WEX::m_szBuffer

De statische buffer, die wordt gebruikt om de geconverteerde tekenreeks op te slaan.

wchar_t m_szBuffer[t_nBufferLength];

CA2WEX::operator LPWSTR

Conversieoperator.

operator LPWSTR() const throw();

Retourwaarde

Retourneert de tekenreeks als type LPWSTR.

Zie ook

CA2AEX-klasse
CA2CAEX-klasse
CW2AEX-klasse
CW2CWEX-klasse
CW2WEX-klasse
Overzicht van klassen