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.
template <int t_nBufferLength = 128>
class CA2AEX
t_nBufferLength
Die Größe des puffers, der im Übersetzungsprozess verwendet wird. Die Standardlänge beträgt 128 Bytes.
Name | Beschreibung |
---|---|
CA2AEX::CA2AEX | Der Konstruktor. |
CA2AEX::~CA2AEX | Der Destruktor. |
Name | Beschreibung |
---|---|
CA2AEX::operator LPSTR | Konvertierungsoperator. |
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. |
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.
Ein Beispiel für die Verwendung dieser Zeichenfolgenkonvertierungsmakros finden Sie unter ATL- und MFC-Zeichenfolgenkonvertierungsmakros.
Kopfzeile: atlconv.h
Der Konstruktor.
CA2AEX(LPCSTR psz, UINT nCodePage) throw(...);
CA2AEX(LPCSTR psz) throw(...);
psz
Die zu konvertierende Textzeichenfolge.
nCodePage
In dieser Klasse nicht verwendet.
Erstellt den für die Übersetzung erforderlichen Puffer.
Der Destruktor.
~CA2AEX() throw();
Gibt den zugeordneten Puffer frei.
Das Datenelement, das die Quellzeichenfolge speichert.
LPSTR m_psz;
Der statische Puffer, der zum Speichern der konvertierten Zeichenfolge verwendet wird.
char m_szBuffer[ t_nBufferLength];
Konvertierungsoperator.
operator LPSTR() const throw();
Gibt die Textzeichenfolge als Typ LPSTR zurück.
CA2CAEX-Klasse
CA2WEX-Klasse
CW2AEX-Klasse
CW2CWEX-Klasse
CW2WEX-Klasse
Klassenübersicht