Classe de CStringData
Esta classe representa os dados de um objeto de cadeia de caracteres.
struct CStringData
Membros
Métodos
Sai contagem de referência de objeto de dados de cadeia de caracteres. |
|
Recupera dados de caractere de um objeto de cadeia de caracteres. |
|
Determina se o buffer do objeto associado de cadeia de caracteres é bloqueado. |
|
Determina se o buffer do objeto associado de cadeia de caracteres é compartilhado no momento. |
|
Bloqueia o buffer do objeto associado de cadeia de caracteres. |
|
Libera o objeto de cadeia de caracteres especificado. |
|
Desbloqueia o buffer do objeto associado de cadeia de caracteres. |
Membros de dados
Comprimento de dados atribuídos em XCHARs (não incluindo de terminação o zero) |
|
Comprimento de dados atualmente usados em XCHARs (não incluindo de terminação o zero) |
|
A contagem de referência de objeto atual. |
|
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 .
Observação |
---|
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.
Observação 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