CA2AEX-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 en CT2AEX en de typedef CA2A.

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 CA2AEX

Parameterwaarden

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

Leden

Openbare constructors

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

Openbare operators

Naam	Description
CA2AEX::operator LPSTR	Conversieoperator.

Publieke dataleden

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

Opmerkingen

Gebruik CA2TEX, CT2AEX of CA2AA in uw eigen code, tenzij er extra functionaliteit is vereist.

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.

De volgende macro's zijn gebaseerd op deze klasse:

• CA2TEX

• CT2AEX

De volgende typedef is gebaseerd op deze klasse:

• CA2A

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

CA2AEX::CA2AEX

De constructor.

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

Parameterwaarden

psz
De tekenreeks die moet worden geconverteerd.

nCodePage
Niet gebruikt in deze klasse.

Opmerkingen

Hiermee maakt u de buffer die nodig is voor de vertaling.

CA2AEX::~CA2AEX

De destructor.

~CA2AEX() throw();

Opmerkingen

Hiermee wordt de toegewezen buffer vrijgemaakt.

CA2AEX::m_psz

Het gegevenslid waarin de brontekenreeks wordt opgeslagen.

LPSTR m_psz;

CA2AEX::m_szBuffer

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

char m_szBuffer[ t_nBufferLength];

CA2AEX::operator LPSTR

Conversieoperator.

operator LPSTR() const throw();

Retourwaarde

Retourneert de tekenreeks als type LPSTR.

Zie ook

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