Classe CStringData

Esta classe representa os dados de um objeto string.

Sintaxe

struct CStringData

Membros

Methods

Membros de Dados

Observações

Esta classe deve ser usada apenas por programadores que implementam gestores de strings personalizados. Para mais informações sobre gestores de strings personalizados, consulte Gestão de Memória e CStringT

Esta classe encapsula vários tipos de informação e dados associados a um objeto de string superior, como objetos CStringT, CSimpleStringT ou CFixedStringT . Cada objeto string superior contém um apontador para o seu objeto associado CStringData , permitindo que múltiplos objetos string apontem para o mesmo objeto de dados de string. Esta relação é representada pela contagem de referências (nRefs) do CStringData objeto.

Estes dados são compostos por:

• O gestor de memória (do tipo IAtlStringMgr) da cadeia.

• O comprimento atual ( nDataLength) da corda.

• O comprimento atribuído ( nAllocLength) da corda. Por razões de desempenho, isto pode diferir do comprimento atual da corda

• A contagem atual de referências ( nRefs) do CStringData objeto. Este valor é usado para determinar quantos objetos string partilham o mesmo CStringData objeto.

• O buffer real de caracteres ( data) da cadeia.

  Observação

  O buffer de caracteres real do objeto string é alocado pelo gestor de string e é anexado ao CStringData objeto.

Requerimentos

Cabeçalho: atlsimpstr.h

CStringData::AddRef

Incrementa a contagem de referência do objeto string.

void AddRef() throw();

Observações

Incrementa a contagem de referência do objeto string.

CStringData::d ata

Devolve um ponteiro para o buffer de caracteres de um objeto string.

void* data() throw();

Valor de retorno

Um apontador para o buffer de caracteres do objeto string.

Observações

Chame esta função para devolver o buffer de caracteres atual do objeto string associado.

CStringData::IsLocked

Determina se o buffer de personagem está bloqueado.

bool IsLocked() const throw();

Valor de retorno

Retorna TRUE se o buffer estiver bloqueado; caso contrário, FALSO.

Observações

Chame esta função para determinar se o buffer de caracteres de um objeto string está atualmente bloqueado.

CStringData::IsShared

Determina se o buffer de personagem é partilhado.

bool IsShared() const throw();

Valor de retorno

Retorna TRUE se o buffer for partilhado; caso contrário, FALSO.

Observações

Chame esta função para determinar se o buffer de caracteres de um objeto de dados string está atualmente partilhado entre múltiplos objetos string.

CStringData::Lock

Bloqueia o buffer de caracteres do objeto string associado.

void Lock() throw();

Observações

Chame esta função para bloquear o buffer de caracteres do objeto de dados da cadeia. O bloqueio e desbloqueio é usado quando o desenvolvedor exige acesso direto ao buffer de personagens. Um bom exemplo de bloqueio é demonstrado pelos métodos LockBuffer e UnlockBuffer de CSimpleStringT.

CStringData::nAllocLength

Comprimento do buffer de carácter atribuído.

int nAllocLength;

Observações

Armazena o comprimento do buffer de dados alocado em XCHARs (excluindo a terminação nula).

CStringData::nDataLength

Comprimento atual do objeto da corda.

int nDataLength;

Observações

Armazena o comprimento dos dados atualmente usados em XCHARs (excluindo a terminação nula).

CStringData::nRefs

Contagem de referências do objeto de dados da cadeia.

long nRefs;

Observações

Armazena a contagem de referência do objeto de dados da cadeia. Esta contagem indica o número de objetos string mais altos associados ao objeto de dados de string. Um valor negativo indica que o objeto de dados string está atualmente bloqueado.

CStringData::p StringMgr

O gestor de memória do objeto string associado.

IAtlStringMgr* pStringMgr;

Observações

Armazena o gestor de memória para o objeto string associado. Para mais informações sobre gestores de memória e strings, consulte Gestão de Memória e CStringT.

CStringData::Release

Diminui a contagem de referência do objeto de dados da cadeia.

void Release() throw();

Observações

Chame esta função para decrementar a contagem de referência, libertando a CStringData estrutura se a contagem de referência atingir zero. Isto é comum quando um objeto string é eliminado e, por isso, já não precisa de referenciar o objeto de dados string.

Por exemplo, o seguinte código chamaria CStringData::Release o objeto de dados string associado a str1:

{
   CString str1 = _T("Hello world");  // Allocates new CStringData
}
// str1 is deleted when it goes out of scope, so it releases its string data   

CStringData::Desbloquear

Desbloqueia o buffer de caracteres do objeto string associado.

void Unlock() throw();

Observações

Chame esta função para desbloquear o buffer de caracteres do objeto de dados da cadeia. Uma vez desbloqueado um buffer, é partilhável e pode ser contado por referência.

O bloqueio e desbloqueio é usado quando o programador tem de garantir que os dados da cadeia não são partilhados. Um bom exemplo de bloqueio é demonstrado pelos métodos LockBuffer e UnlockBuffer de CSimpleStringT.

Consulte também

Gráfico de Hierarquia
Classes compartilhadas ATL/MFC