Freigeben über


CA2AEX-Klasse

Diese Klasse wird von den Zeichenfolgenkonvertierungsmakros CA2TEX und CT2AEX und der typedef CA2A 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 CA2AEX

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
CA2AEX::CA2AEX Der Konstruktor.
CA2AEX::~CA2AEX Der Destruktor.

Öffentliche Operatoren

Name Beschreibung
CA2AEX::operator LPSTR Konvertierungsoperator.

Öffentliche Datenmember

Name Beschreibung
CA2AEX::m_psz Das Datenelement, das die Quellzeichenfolge speichert.
CA2AEX::m_szBuffer Der statische Puffer, der zum Speichern der konvertierten Zeichenfolge verwendet wird.

Hinweise

Wenn keine zusätzlichen Funktionen erforderlich sind, verwenden Sie CA2TEX, CT2AEX oder CA2A in Ihrem eigenen 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:

  • CA2TEX

  • CT2AEX

Der folgende Typedef basiert auf dieser Klasse:

  • CA2A

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

CA2AEX::CA2AEX

Der Konstruktor.

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

Parameter

psz
Die zu konvertierende Textzeichenfolge.

nCodePage
In dieser Klasse nicht verwendet.

Hinweise

Erstellt den für die Übersetzung erforderlichen Puffer.

CA2AEX::~CA2AEX

Der Destruktor.

~CA2AEX() throw();

Hinweise

Gibt den zugeordneten Puffer frei.

CA2AEX::m_psz

Das Datenelement, das die Quellzeichenfolge speichert.

LPSTR m_psz;

CA2AEX::m_szBuffer

Der statische Puffer, der zum Speichern der konvertierten Zeichenfolge verwendet wird.

char m_szBuffer[ t_nBufferLength];

CA2AEX::operator LPSTR

Konvertierungsoperator.

operator LPSTR() const throw();

Rückgabewert

Gibt die Textzeichenfolge als Typ LPSTR zurück.

Siehe auch

CA2CAEX-Klasse
CA2WEX-Klasse
CW2AEX-Klasse
CW2CWEX-Klasse
CW2WEX-Klasse
Klassenübersicht