CW2WEX-Klasse
Diese Klasse wird von den Zeichenfolgenkonvertierungsmakros CW2TEX und CT2WEX und dem typedef CW2W verwendet.
Wichtig
Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.
Syntax
template <int t_nBufferLength = 128>
class CW2WEX
Parameter
t_nBufferLength
Die Größe des puffers, der im Übersetzungsprozess verwendet wird. Die Standardlänge beträgt 128 Bytes.
Member
Öffentliche Konstruktoren
Name | Beschreibung |
---|---|
CW2WEX::CW2WEX | Der Konstruktor. |
CW2WEX::~CW2WEX | Der Destruktor. |
Öffentliche Operatoren
Name | Beschreibung |
---|---|
CW2WEX::operator LPWSTR | Konvertierungsoperator. |
Öffentliche Datenmember
Name | Beschreibung |
---|---|
CW2WEX::m_psz | Das Datenelement, das die Quellzeichenfolge speichert. |
CW2WEX::m_szBuffer | Der statische Puffer, der zum Speichern der konvertierten Zeichenfolge verwendet wird. |
Hinweise
Wenn keine zusätzlichen Funktionen erforderlich sind, verwenden Sie CW2TEX, CT2WEX oder CW2W in Ihrem Code.
Diese Klasse enthält einen statischen Puffer mit fester Größe, der zum Speichern des Ergebnisses der Konvertierung verwendet wird. Wenn das Ergebnis zu groß ist, um in den statischen Puffer einzupassen, weist die Klasse Speicher mithilfe von Malloc zu, wodurch der Speicher freigegeben wird, wenn das Objekt nicht mehr im Bereich liegt. Dadurch wird sichergestellt, dass diese Klasse im Gegensatz zu Textkonvertierungsmakros, die in früheren Versionen von ATL verfügbar sind, sicher in Schleifen verwendet werden kann und der Stapel nicht überläuft.
Wenn die Klasse versucht, Speicher für den Heap zuzuweisen und fehlschlägt, wird sie mit einem Argument von E_OUTOFMEMORY aufgerufen AtlThrow
.
Standardmäßig verwenden die ATL-Konvertierungsklassen und -Makros die ANSI-Codeseite des aktuellen Threads für die Konvertierung.
Die folgenden Makros basieren auf dieser Klasse:
CW2TEX
CT2WEX
Der folgende Typedef basiert auf dieser Klasse:
- CW2W
Eine Erläuterung dieser Textkonvertierungsmakros finden Sie unter ATL- und MFC-Zeichenfolgenkonvertierungsmakros.
Beispiel
Ein Beispiel für die Verwendung dieser Zeichenfolgenkonvertierungsmakros finden Sie unter ATL- und MFC-Zeichenfolgenkonvertierungsmakros.
Anforderungen
Kopfzeile: atlconv.h
CW2WEX::CW2WEX
Der Konstruktor.
CW2WEX(LPCWSTR psz, UINT nCodePage) throw(...);
CW2WEX( LPCWSTR psz) throw(...);
Parameter
psz
Die zu konvertierende Textzeichenfolge.
nCodePage
Die Codepage. Wird in dieser Klasse nicht verwendet.
Hinweise
Erstellt den für die Übersetzung erforderlichen Puffer.
CW2WEX::~CW2WEX
Der Destruktor.
~CW2WEX() throw();
Hinweise
Gibt den zugeordneten Puffer frei.
CW2WEX::m_psz
Das Datenelement, das die Quellzeichenfolge speichert.
LPWSTR m_psz;
CW2WEX::m_szBuffer
Der statische Puffer, der zum Speichern der konvertierten Zeichenfolge verwendet wird.
wchar_t m_szBuffer[t_nBufferLength];
CW2WEX::operator LPWSTR
Umwandlungsoperator.
operator LPWSTR() const throw();
Rückgabewert
Gibt die Textzeichenfolge als Typ LPWSTR zurück.
Siehe auch
CA2AEX-Klasse
CA2CAEX-Klasse
CA2WEX-Klasse
CW2AEX-Klasse
CW2CWEX-Klasse
Klassenübersicht