Classe CStringArray

Dá suporte a matrizes de objetos CString.

Sintaxe

class CStringArray : public CObject

Membros

As funções de membro de CStringArray são semelhantes às funções de membro da classe CObArray. Devido a essa semelhança, é possível usar a documentação de referência da CObArray para obter a função específica de membro. Ao ver um ponteiro CObject como valor retornado, substitua um objeto CString (não um ponteiro CString). Ao ver um ponteiro de CObject como um parâmetro de função, substitua um LPCTSTR.

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

por exemplo, traduz para

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

e

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

traduz para

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

Construtores públicos

Nome	Descrição
CStringArray::CStringArray	Constrói uma matriz vazia.

Métodos públicos

Nome	Descrição
CStringArray::Add	Inclui um elemento ao final da matriz; aumenta a matriz quando necessário.
CStringArray::Append	Acrescenta outra matriz à matriz; aumenta a matriz quando necessário.
CStringArray::Copy	Copia outra matriz à matriz; aumenta a matriz quando necessário.
CStringArray::ElementAt	Retorna uma referência temporária ao ponteiro do elemento dentro da matriz.
CStringArray::FreeExtra	Libera toda memória não usada acima do limite superior atual.
CStringArray::GetAt	Retorna o valor a um determinado índice.
CStringArray::GetCount	Obtém o número de elementos nesta matriz.
CStringArray::GetData	Permite acesso aos elementos na matriz. Pode ser NULL.
CStringArray::GetSize	Obtém o número de elementos nesta matriz.
CStringArray::GetUpperBound	Retorna o maior índice válido.
CStringArray::InsertAt	Insere um elemento (ou todos os elementos em outra matriz) em um índice especificado.
CStringArray::IsEmpty	Determina se a matriz está vazia.
CStringArray::RemoveAll	Remove todos os elementos dessa matriz.
CStringArray::RemoveAt	Remove um elemento a um índice específico.
CStringArray::SetAt	Define o valor de um determinado índice; não é permitido à matriz aumentar.
CStringArray::SetAtGrow	Define o valor de um determinado índice; aumenta a matriz quando necessário.
CStringArray::SetSize	Define o número de elementos a ser contido nesta matriz.

Operadores públicos

Nome	Descrição
CStringArray::operator [ ]	Define ou obtém o elemento no índice especificado.

Comentários

A CStringArray incorpora a macro IMPLEMENT_SERIAL para suportar serialização e despejo de seus elementos. Se uma matriz de objetos CString for armazenada em um arquivo, com um operador de inserção sobrecarregado ou com a função de membro Serialize, cada elemento é serializado por vez.

Observação

Antes de usar uma matriz, utilize SetSize para estabelecer seu tamanho e alocar memória para ela. Se SetSize não for utilizado, incluir elementos à matriz fará com que ela seja frequentemente realocada e copiada. Realocações e cópias frequentes são ineficientes e podem fragmentar a memória.

Se for necessário um despejo de elementos de cadeia de caracteres individuais na matriz, será necessário definir a profundidade do contexto do despejo para 1 ou maior.

Quando uma matriz CString é excluída ou quando seus elementos são removidos, a memória da cadeia de caracteres é liberada conforme adequado.

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

Hierarquia de herança

CObject

CStringArray

Requisitos

Cabeçalho: afxcoll.h

Confira também

Classe CObject
Gráfico da hierarquia