Compartilhar via


Classe de CStringData

Esta classe representa os dados de um objeto de cadeia de caracteres.

struct CStringData

Membros

Métodos

AddRef

Sai contagem de referência de objeto de dados de cadeia de caracteres.

dados

Recupera dados de caractere de um objeto de cadeia de caracteres.

IsLocked

Determina se o buffer do objeto associado de cadeia de caracteres é bloqueado.

IsShared

Determina se o buffer do objeto associado de cadeia de caracteres é compartilhado no momento.

Bloquear

Bloqueia o buffer do objeto associado de cadeia de caracteres.

Versão

Libera o objeto de cadeia de caracteres especificado.

Unlock

Desbloqueia o buffer do objeto associado de cadeia de caracteres.

Membros de dados

nAllocLength

Comprimento de dados atribuídos em XCHARs (não incluindo de terminação o zero)

nDataLength

Comprimento de dados atualmente usados em XCHARs (não incluindo de terminação o zero)

nRefs

A contagem de referência de objeto atual.

pStringMgr

Um ponteiro ao gerenciador de cadeia de caracteres de esse objeto de cadeia de caracteres.

Comentários

Essa classe deve ser usada somente os desenvolvedores que implementam gerentes personalizados de cadeia de caracteres. Para obter mais informações sobre os gerentes personalizados de cadeia de caracteres, consulte gerenciamento de memória e CStringT

Essa classe encapsula vários tipos de informação e os dados associados com uma cadeia de caracteres mais alta objetos, como objetos de CStringT, de CSimpleStringT, ou de CFixedStringT . Cada objeto de uma cadeia de caracteres mais alta contém um ponteiro para seu respectivo objeto de CStringData , permitindo vários objetos de cadeia de caracteres para apontar para o mesmo objeto de dados de cadeia de caracteres. Esse relacionamento é representada pela contagem de referência (nRefs) do objeto de CStringData .

Dica

Em alguns casos, um tipo cadeia de caracteres (como) não CFixedStringcompartilhar um objeto de dados de cadeia de caracteres com mais de um objeto de uma cadeia de caracteres mais alta.Para obter mais informações sobre isso, consulte gerenciamento de memória e CStringT.

Esses dados são compostos de:

  • O gerenciador de memória (de tipo IAtlStringMgr) de cadeia de caracteres.

  • O comprimento atual (nDataLength) de cadeia de caracteres.

  • O comprimento atribuído (nAllocLength) de cadeia de caracteres. Por razões de desempenho, isso pode diferir de comprimento atual de cadeia de caracteres

  • A contagem de referência atual (nRefs) do objeto de CStringData. Esse valor é usado em determinar quantos objetos de cadeia de caracteres está compartilhando o mesmo objeto de CStringData .

  • O buffer real de caractere (dados) de cadeia de caracteres.

    Dica

    O buffer real de caracteres do objeto de cadeia de caracteres é determinado pelo gerenciador de cadeia de caracteres e acrescentado ao objeto de CStringData .

Requisitos

Cabeçalho: atlsimpstr.h

Consulte também

Referência

Gráfico da hierarquia

Outros recursos

ATL/MFC compartilhasse classes