Att använda CString

Avsnitten i det här avsnittet beskriver hur du programmerar med CString. Referensdokumentation om CString klassen finns i dokumentationen för CStringT.

Om du vill använda CStringtar du med atlstr.h rubriken.

Klasserna CString, CStringAoch CStringW är specialiseringar för en klassmall som heter CStringT baserat på vilken typ av teckendata de stöder.

Ett CStringW objekt innehåller wchar_t typen och stöder Unicode-strängar. Ett CStringA objekt innehåller char typen och stöder MBCS-strängar (single-byte och multi-byte). Ett CString objekt stöder antingen char typen eller wchar_t typen, beroende på om MBCS-symbolen eller UNICODE-symbolen definieras vid kompileringstillfället.

Ett CString objekt behåller teckendata i ett CStringData objekt. CString accepterar NULL-avslutade C-formatsträngar. CString spårar stränglängden för snabbare prestanda, men den behåller NULL också tecknet i lagrade teckendata för att stödja konvertering till LPCWSTR. CString innehåller null-avslutaren när den exporterar en sträng i C-format. Du kan infoga en NULL på andra platser i en CString, men det kan ge oväntade resultat.

Följande uppsättning strängklasser kan användas utan att länka ett MFC-bibliotek, med eller utan CRT-stöd: CAtlString, CAtlStringAoch CAtlStringW.

CString används i interna projekt. För projekt med hanterad kod (C++/CLI) använder du System::String.

Om du vill lägga till fler funktioner än CString, CStringAeller CStringW för närvarande erbjuder, bör du skapa en underklass av CStringT som innehåller de ytterligare funktionerna.

Följande kod visar hur du skapar och CString skriver ut den till standardutdata:

#include <atlstr.h>

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

I det här avsnittet

Grundläggande CString åtgärder
Beskriver grundläggande CString åtgärder, inklusive att skapa objekt från C-literalsträngar, komma åt enskilda tecken i en CString, sammanfoga två objekt och jämföra CString objekt.

Hantering av strängdata
Diskuterar hur du använder Unicode och MBCS med CString.

CString-semantik
Förklarar hur CString objekt används.

CString-åtgärder relaterade till C-formatsträngar
Beskriver hur du ändrar innehållet i ett CString objekt som en null-avslutad sträng i C-format.

Allokera och frigöra minne för en BSTR
Diskuterar användning av minne för ett BSTR och COM-objekt.

Rensning av CString-undantag
Förklarar att explicit rensning i MFC 3.0 och senare inte längre behövs.

CString-argument skickas
Förklarar hur du skickar CString objekt till funktioner och hur du returnerar CString objekt från funktioner.

Stöd för Unicode- och Multibyte-teckenuppsättning (MBCS)
Beskriver hur MFC är aktiverat för Unicode- och MBCS-stöd.

Hänvisning

CStringT
Innehåller referensinformation om CStringT klassen.

CSimpleStringT Klass
Innehåller referensinformation om CSimpleStringT klassen.

Relaterade avsnitt

Strängar (ATL/MFC)
Innehåller länkar till ämnen som beskriver flera sätt att hantera strängdata.

Strängar (ATL/MFC)