Partilhar via


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