Using CString

Gli argomenti di questa sezione descrivono come programmare con CString. Per la documentazione di riferimento sulla classe CString, vedere la documentazione per CStringT.

Per usare CString, includere l'intestazione atlstr.h.

Le classi CString, CStringA e CStringW sono specializzazioni di un modello di classe denominato CStringT basato sul tipo di dati di tipo carattere supportato.

Un oggetto CStringW contiene il tipo wchar_t e supporta le stringhe Unicode. Un oggetto CStringA contiene il tipo char e supporta le stringhe a byte singolo e multibyte (MBCS). Un oggetto CString supporta il tipo char o wchar_t, a seconda del fatto che in fase di compilazione venga definito il simbolo MBCS o UNICODE.

Un oggetto CString mantiene i dati di tipo carattere in un oggetto CStringData. CString accetta stringhe in formato C con terminazione null, ma non conserva il carattere null nei dati di tipo carattere archiviati. CString tiene invece traccia della lunghezza della stringa. CString fornisce un terminatore null quando esporta una stringa in formato C. È possibile inserire un valore null in un oggetto CString, ma potrebbe provocare risultati imprevisti.

Il set di classi stringa seguente può essere usato senza collegare una libreria MFC, con o senza il supporto della libreria run-time C: CAtlString, CAtlStringA e CAtlStringW.

CString viene usato nei progetti nativi. Per i progetti in codice gestito (C++/CLI), usare System::String.

Per aggiungere funzionalità rispetto a quelle offerte da CString, CStringA o CStringW, creare una sottoclasse di CStringT contenente le funzionalità aggiuntive.

Il codice seguente illustra come creare un oggetto CString e stamparlo in un output standard:

#include <atlstr.h>

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

In questa sezione

• Operazioni di base con CString
  Descrive le operazioni di base di CString, inclusa la creazione di oggetti da stringhe letterali C, l'accesso ai caratteri in un oggetto CString, la concatenazione di due oggetti e il confronto di oggetti CString.

• Gestione dei dati di tipo stringa
  Descrive l'uso di Unicode e MBCS con CString.

• Semantica di CString
  Spiega come usare gli oggetti CString.

• Operazioni di CString relative alle stringhe in formato C
  Descrive la modifica del contenuto di un oggetto CString come una stringa in formato C con terminazione null.

• Allocazione e rilascio di memoria per un oggetto BSTR
  Descrive l'uso della memoria per un oggetto BSTR e per gli oggetti COM.

• Pulizia delle eccezioni di CString
  Spiega che la pulizia esplicita in MFC 3.0 e versione successiva non è più necessaria.

• Passaggio degli argomenti di CString
  Spiega come passare gli oggetti CString alle funzioni e come restituire oggetti CString da funzioni.

• Supporto per set di caratteri Unicode e multibyte (MBCS)
  Descrive il supporto di Unicode e MBCS in MFC.

Riferimenti

• CStringT
  Fornisce informazioni di riferimento sulla classe CStringT.

• CSimpleStringT Class
  Fornisce informazioni di riferimento sulla classe CSimpleStringT.

Sezioni correlate

• Strings (ATL/MFC)
  Contiene collegamenti ad argomenti che descrivono diversi modi per gestire i dati di tipo stringa.

• Creazione di istanze di modelli di classe
  CString è un typedef basato su CStringT, un'istanza di una specializzazione di un modello di classe.

Strings (ATL/MFC)