Compartir a través de


CStringData Class

Esta clase representa los datos de un objeto string.

struct CStringData

Members

Métodos

AddRef

Incrementa el recuento de referencias del objeto de datos de cadena.

datos

Recupera los datos de caracteres de un objeto de cadena.

IsLocked

Determina si el búfer del objeto string asociado está bloqueado.

IsShared

Determina si el búfer del objeto string asociado se comparte actualmente.

Bloquear

Bloquea el búfer del objeto string asociado.

Versión de lanzamiento

Libera el objeto especificado de la cadena.

Unlock

Desbloquea el búfer del objeto string asociado.

miembros de datos

nAllocLength

Longitud de datos asignados en s para XCHAR(sin incluir finalizar null)

nDataLength

Longitud de datos actualmente utilizados en s para XCHAR(sin incluir finalizar null)

nRefs

El número actual de la referencia de objeto.

pStringMgr

Un puntero al administrador de cadena de este objeto de cadena.

Comentarios

Esta clase debe utilizarse únicamente los desarrolladores que implementan a administradores de cadena personalizados. Para obtener más información sobre administradores de cadena personalizados, vea administración de memoria y CStringT

Esta clase encapsula distintos tipos de información y datos asociados a un objeto string más alto, como objetos de CStringT, de CSimpleStringT, o de CFixedStringT . Cada objeto string superior contiene un puntero al objeto asociado de CStringData , lo objetos string al punto al mismo objeto de datos de cadena. Esta relación se representa mediante el recuento de referencias (nRefs) del objeto de CStringData .

Nota

En algunos casos, un tipo string (como CFixedString) no compartir un objeto de datos de cadena con más de un objeto string más alto.Para obtener más información sobre esto, vea administración de memoria y CStringT.

Estos datos se compone de:

  • El administrador de memoria (de IAtlStringMgrtipo) de la cadena.

  • La longitud actual (nDataLength) de la cadena.

  • La longitud asignada (nAllocLength) de la cadena. Por razones de rendimiento, esto puede diferir de la longitud actual de la cadena

  • El número actual de referencia (nRefs) del objeto de CStringData . Este valor se utiliza en determinar cuántos objetos string están compartiendo el mismo objeto de CStringData .

  • El búfer real de caracteres (datos) de la cadena.

    Nota

    El búfer real de caracteres del objeto string es asignado por el administrador de la cadena y con el objeto de CStringData .

Requisitos

encabezado: atlsimpstr.h

Vea también

Referencia

Gráfico de jerarquías

Otros recursos

ATL/MFC Shared Classes