Utilisation de CString

Les rubriques de cette section décrivent comment programmer avec CString. Pour obtenir une documentation de référence sur la CString classe, consultez la documentation pour CStringT.

Pour utiliser CString, incluez l'en-tête atlstr.h.

Les CStringclasses et CStringW les classes CStringAsont des spécialisations d’un modèle de classe appelé CStringT en fonction du type de données caractères qu’ils prennent en charge.

Un CStringW objet contient le wchar_t type et prend en charge les chaînes Unicode. Un CStringA objet contient le char type et prend en charge les chaînes monooctets et multioctets (Mo CS). Un CString objet prend en charge le char type ou le type, selon que le symbole Mo CS ou le symbole UNICODE est défini au moment de la wchar_t compilation.

Un objet CString conserve les données caractères dans un objet CStringData. CString accepte les chaînes de style C terminées par NULL. CString effectue le suivi de la longueur de la chaîne pour accélérer les performances, mais conserve également le caractère dans les données de caractères stockées pour prendre en charge la NULL conversion en LPCWSTR. CString inclut le terminateur Null lorsqu’il exporte une chaîne de style C. Vous pouvez insérer un NULL emplacement à d’autres emplacements dans un CString, mais il peut produire des résultats inattendus.

L'ensemble suivant de classes de chaîne peut être utilisé sans liaison avec la bibliothèque MFC, avec ou sans prise en charge de CRT : CAtlString, CAtlStringA et CAtlStringW.

CString est utilisé dans les projets natifs. Pour les projets en code managé (C++/CLI), utilisez System::String.

Pour ajouter davantage de capacités à celles actuellement offertes par CString, CStringA ou CStringW, vous devez créer une sous-classe de CStringT qui contient les fonctionnalités supplémentaires.

Le code suivant montre comment créer un objet CString et l'imprimer dans la sortie standard :

#include <atlstr.h>

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

Dans cette section

Opérations de base CString
Décrit les opérations CString de base, y compris la création d'objets à partir de chaînes littérales C, l'accès à des caractères individuels d'un objet CString, la concaténation de deux objets et la comparaison d'objets CString.

Gestion des données chaînes
Présente l'utilisation de Unicode et MBCS avec CString.

Sémantique CString
Explique comment les objets CString sont utilisés.

Opérations CString relatives aux chaînes de style C
Décrit la manipulation du contenu d'un objet CString sous la forme d'une chaîne de style C terminée par un caractère null.

Allocation et libération de la mémoire pour un BSTR
Traite de l’utilisation de la mémoire pour un objet COM et un BSTR objet COM.

Nettoyage des exceptions CString
Explique qu'un nettoyage explicite dans MFC 3.0 et ultérieur n'est plus nécessaire.

Passage d’arguments CString
Explique comment passer des objets à des CString fonctions et comment retourner CString des objets à partir de fonctions.

Prise en charge des jeux de caractères Unicode et MBCS (Multibyte Character Set)
Explique comment MFC prend en charge Unicode et MBCS.

Référence

CStringT
Fournit des informations de référence sur la classe CStringT.

CSimpleStringT Classe
Fournit des informations de référence sur la classe CSimpleStringT.

Sections connexes

Chaînes (ATL/MFC)
Contient des liens vers des rubriques décrivant plusieurs façons de gérer les données chaînes.

Chaînes (ATL/MFC)