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 Byte.

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