CW2WEX-klasse
Deze klasse wordt gebruikt door de tekenreeksconversiemacro's CW2TEX en CT2WEX, en de typedef CW2W.
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 CW2WEX
Parameters
t_nBufferLength
De grootte van de buffer die in het vertaalproces wordt gebruikt. De standaardlengte is 128 bytes.
Leden
Openbare constructors
Naam | Beschrijving |
---|---|
CW2WEX::CW2WEX- | De constructor. |
CW2WEX::~CW2WEX- | De destructor. |
Openbare operators
Naam | Beschrijving |
---|---|
CW2WEX::operator LPWSTR | Conversieoperator. |
Leden van openbare gegevens
Naam | Beschrijving |
---|---|
CW2WEX::m_psz | Het gegevenslid waarin de brontekenreeks wordt opgeslagen. |
CW2WEX::m_szBuffer | De statische buffer, die wordt gebruikt om de geconverteerde tekenreeks op te slaan. |
Opmerkingen
Tenzij extra functionaliteit is vereist, gebruikt u CW2TEX, CT2WEX of CW2W 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 behulp van malloc-, waardoor het geheugen vrij komt wanneer het object buiten het bereik komt. 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 AtlThrow
aangeroepen 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:
CW2TEX
CT2WEX
De volgende typedef is gebaseerd op deze klasse:
- CW2W
Zie ATL- en MFC-tekenreeksconversiemacro'svoor een bespreking van deze tekstconversiemacro's.
Voorbeeld
Zie ATL- en MFC-tekenreeksconversiemacro's voor een voorbeeld van het gebruik van deze tekenreeksconversiemacro's.
Eisen
koptekst: atlconv.h
CW2WEX::CW2WEX
De constructor.
CW2WEX(LPCWSTR psz, UINT nCodePage) throw(...);
CW2WEX( LPCWSTR psz) throw(...);
Parameters
psz-
De tekenreeks die moet worden geconverteerd.
nCodePage-
De codepagina. Niet gebruikt in deze klasse.
Opmerkingen
Hiermee maakt u de buffer die nodig is voor de vertaling.
CW2WEX::~CW2WEX
De destructor.
~CW2WEX() throw();
Opmerkingen
Hiermee wordt de toegewezen buffer vrijgemaakt.
CW2WEX::m_psz
Het gegevenslid waarin de brontekenreeks wordt opgeslagen.
LPWSTR m_psz;
CW2WEX::m_szBuffer
De statische buffer, die wordt gebruikt om de geconverteerde tekenreeks op te slaan.
wchar_t m_szBuffer[t_nBufferLength];
CW2WEX::operator LPWSTR
Cast-operator.
operator LPWSTR() const throw();
Retourwaarde
Retourneert de tekenreeks als type LPWSTR.
Zie ook
CA2AEX-klasse
CA2CAEX klasse
CA2WEX-klasse
CW2AEX-klasse
CW2CWEX Klasse-
Class Overview