Verwenden von CString

In den Themen in diesem Abschnitt wird die Programmierung mit CString beschrieben. Referenzdokumentation zur CString Klasse finden Sie in der Dokumentation für CStringT.

Schließen Sie zum Verwenden von CString den atlstr.h-Header ein.

Die CStringKlassen CStringAund CStringW Klassen sind Spezialisierungen einer Klassenvorlage, die basierend auf dem Typ der von ihnen unterstützten Zeichendaten aufgerufen CStringT wird.

Ein CStringW Objekt enthält den wchar_t Typ und unterstützt Unicode-Zeichenfolgen. Ein CStringA Objekt enthält den char Typ und unterstützt Single-Byte- und Multi-Byte-Zeichenfolgen (MBCS). Ein CString Objekt unterstützt entweder den char Typ oder den wchar_t Typ, je nachdem, ob das MBCS-Symbol oder das UNICODE-Symbol zur Kompilierungszeit definiert ist.

Ein CString-Objekt hält Zeichendaten in einem CStringData-Objekt. CString akzeptiert NULL-gekündigte C-Formatzeichenfolgen. CString verfolgt die Länge der Zeichenfolge für eine schnellere Leistung, behält aber auch das NULL Zeichen in den gespeicherten Zeichendaten bei, um die Konvertierung zu LPCWSTRunterstützen. CString enthält den NULL-Terminator, wenn er eine C-Formatzeichenfolge exportiert. Sie können eine NULL an anderen Stellen in einer CString, aber möglicherweise unerwartete Ergebnisse erzeugen.

Der folgende Satz von Zeichenfolgenklassen kann verwendet werden, ohne eine MFC-Bibliothek mit oder ohne CRT-Unterstützung zu verknüpfen: CAtlString, , CAtlStringAund CAtlStringW.

CString wird in systemeigenen Projekten verwendet. Verwenden Sie für Projekte mit verwaltetem Code (C++/CLI) System::String.

Um mehr Funktionen hinzuzufügen als CString, CStringA oder CStringW derzeit bieten, sollten Sie eine Unterklasse von CStringT erstellen, die die zusätzlichen Funktionen enthält.

Der folgende Code zeigt, wie Sie einen CString erstellen und als Standardausgabe drucken können:

#include <atlstr.h>

int main() {
    CString aCString = CString(_T("A string"));
    _tprintf(_T("%s"), (LPCTSTR) aCString);
}

In diesem Abschnitt

Grundlegende CString Vorgänge
Beschreibt grundlegende CString-Vorgänge, darunter das Erstellen von Objekten aus C-Literal-Zeichenfolgen, das Zugreifen auf einzelne Zeichen in einem CString, das Verketten von zwei Objekten und das Vergleichen von CString-Objekten.

Zeichenfolgendatenverwaltung
Erläutert die Nutzung von Unicode und MBCS mit CString.

CString-Semantik
Erläutert, wie CString-Objekte verwendet werden.

CString-Operationen bei Zeichenfolgen im C-Format
Beschreibt die Manipulation der Inhalte eines CString-Objekts wie eine mit Null abschließende Zeichenfolge im C-Format.

Zuordnen und Freigeben von Arbeitsspeicher für ein BSTR
Erläutert die Verwendung des Arbeitsspeichers für ein BSTR und COM-Objekte.

CString-Ausnahmebereinigung
Erklärt, dass eine explizite Bereinigung in MFC 3.0 und höher nicht mehr notwendig ist.

CString-Argumentübergabe
Erläutert, wie Objekte an Funktionen übergeben CString werden und wie Objekte aus Funktionen zurückgegeben CString werden.

Unterstützung für Unicode- und Multibyte-Zeichensätze (MBCS)
Beschreibt, wie MFC für Unicode- und MBCS-Unterstützung aktiviert wird.

Verweis

CStringT
Bietet Referenzinformationen zur CStringT-Klasse.

CSimpleStringT Klasse
Bietet Referenzinformationen zur CSimpleStringT-Klasse.

Verwandte Abschnitte

Zeichenfolgen (ATL/MFC)
Enthält Links zu Themen, in denen verschiedene Methoden zum Verwalten von Zeichenfolgendaten beschrieben werden.

Zeichenfolgen (ATL/MFC)