Classe CStringArray

Artigo
08/25/2010

Oferece suporte para conjuntos de CString objetos.

class CStringArray : public CObject

Comentários

As funções de membro de CStringArray são semelhantes às funções de membro de classe CObArray.Por causa dessa semelhança, você pode usar o CObArray documentação de referência para obter informações mais específicas de função de membro. Onde quer que você vê um CObject ponteiro sistema autônomo um valor retornado, substituir um CString (não um CString ponteiro). Onde quer que você vê um CObject ponteiro sistema autônomo um parâmetro de função, substituir um LPCTSTR.

CObject* CObArray::GetAt( int <nIndex> ) const;

Por exemplo, se traduz em

CString CStringArray::GetAt( int <nIndex> ) const;

void SetAt( int <nIndex>, CObject* <newElement> )

se traduz em

void SetAt( int <nIndex>, LPCTSTR <newElement> )

CStringArray incorpora o IMPLEMENT_SERIAL macro para oferecer suporte a serialização e despejo de seus elementos. Se um array de CString objetos é armazenado para um arquivar com um operador sobrecarregado inserção ou com o Serialize função de membro, cada elemento é serializada por sua vez.

Observação:
Antes de usar uma matriz, use SetSize para estabelecer seu dimensionar e alocar memória para ele. Se você não usar SetSize, adicionando elementos ao seu conjunto faz com que ela ser realocados com freqüência e copiado. Realocação freqüente e copiar são ineficientes e podem fragmentar memória.

Se você precisar de um despejo de seqüência de caracteres individuais elementos na matriz, você deve conjunto a profundidade do contexto de despejo para 1 ou maior.

Quando um CString matriz for excluído, ou quando seus elementos são removidos, seqüência de caracteres de memória seja liberada sistema autônomo apropriado.

Para obter mais informações sobre como usar CStringArray, consulte o artigo Coleções.