Partager via

CStringData, classe

  • Article

Cette classe représente les données d'un objet chaîne.

struct CStringData

Membres

Méthodes

AddRef

Incrémente le décompte de références de l'objet de données de type chaîne.

data

Récupère les données caractères d'un objet chaîne.

IsLocked

Détermine si la mémoire tampon de l'objet String associé est verrouillée.

IsShared

Détermine si la mémoire tampon de l'objet String associé est actuellement partagée.

Verrouiller

Verrouille la mémoire tampon de l'objet String associé.

Release

Libère l'objet chaîne spécifiée.

Déverrouillez

Déverrouille la mémoire tampon de l'objet String associé.

Membres de données

nAllocLength

Longueur des données allouées dans XCHARs (sans fin null)

nDataLength

Longueur des données actuellement utilisées dans XCHARs (sans fin null)

nRefs

Le décompte de références actuel de l'objet.

pStringMgr

Pointeur vers le gestionnaire de chaînes de cet objet chaîne.

Notes

Cette classe doit être utilisée par les développeurs implémentant des gestionnaires de chaînes personnalisés. Pour plus d'informations sur les gestionnaires de chaînes personnalisés, consultez gestion de la mémoire et CStringT

Cette classe encapsule plusieurs types d'informations et des données associées à un objet chaîne supérieur, tels que des objets de CStringT, de CSimpleStringT, ou de CFixedStringT . Chaque objet chaîne supérieur contient un pointeur vers l'objet associé à CStringData , ce qui permet à plusieurs objets chaîne pour indiquer le même objet de données de type chaîne. Cette relation est représentée par le décompte de références (nRefs) de l'objet d' CStringData .

Notes

Dans certains cas, un type chaîne (tel que CFixedString) ne partagera pas un objet de données de type chaîne avec plusieurs objets String supérieur.Pour plus d'informations sur cette opération, consultez gestion de la mémoire et CStringT.

Ces données sont composées de :

  • Le gestionnaire de mémoire (de type IAtlStringMgr) de la chaîne.

  • La longueur actuelle (nDataLength) de la chaîne.

  • La longueur allouée (nAllocLength) de la chaîne. Pour des raisons de performances, cela peut différer de la longueur de chaîne actuelle

  • Le décompte de références actuel (nRefs) de l'objet d' CStringData . Cette valeur est utilisée pour déterminer le nombre d'objets chaîne partagent le même objet d' CStringData .

  • La mémoire tampon de caractères réel (données) de la chaîne.

    Notes

    La mémoire tampon de caractères réel de l'objet String est alloué par le gestionnaire de chaînes et est ajouté à l'objet d' CStringData .

Configuration requise

Header: atlsimpstr.h

Voir aussi

Référence

Graphique de la hiérarchie

Autres ressources

ATL/MFC étapes partagées des classes