CStringArray Classe

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Suporta conjuntos de CString objetos.

Sintaxe

class CStringArray : public CObject

Membros

As funções membros de CStringArray são semelhantes às funções membros da classe CObArray. Devido a esta semelhança, pode usar a CObArray documentação de referência para especificações da função dos membros. Sempre que vir um CObject ponteiro como valor de retorno, substitua um CString objeto (não um CString ponteiro). Sempre que vê um CObject ponteiro como parâmetro de função, substitua por um LPCTSTR.

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

por exemplo, traduz-se em

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

e ainda

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

traduz-se por

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

Construtores Públicos

Nome	Description
CStringArray::CStringArray	Constrói um array vazio.

Métodos Públicos

Nome	Description
CStringArray::Add	Adiciona um elemento ao final do array; Cresce a matriz se necessário.
CStringArray::Append	Adiciona outro array ao array; Cresce a matriz se necessário.
CStringArray::Copy	Copia outro array para o array; Cresce a matriz se necessário.
CStringArray::ElementAt	Devolve uma referência temporária ao ponteiro de elemento dentro do array.
CStringArray::FreeExtra	Liberta toda a memória não utilizada acima do limite superior atual.
CStringArray::GetAt	Devolve o valor num dado índice.
CStringArray::GetCount	Obtém o número de elementos neste array.
CStringArray::GetData	Permite o acesso a elementos no array. Pode ser NULL.
CStringArray::GetSize	Obtém o número de elementos neste array.
CStringArray::GetUpperBound	Devolve o maior índice válido.
CStringArray::InsertAt	Insere um elemento (ou todos os elementos de outro array) num índice especificado.
CStringArray::IsEmpty	Determina se o array está vazio.
CStringArray::RemoveAll	Remove todos os elementos deste array.
CStringArray::RemoveAt	Remove um elemento num índice específico.
CStringArray::SetAt	Define o valor para um dado índice; Array não pode crescer.
CStringArray::SetAtGrow	Define o valor para um dado índice; Cresce a matriz se necessário.
CStringArray::SetSize	Define o número de elementos a serem contidos neste arranjo.

Operadores Públicos

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

Observações

CStringArray incorpora a IMPLEMENT_SERIAL macro para suportar a serialização e o despejo dos seus elementos. Se um array de CString objetos for armazenado num arquivo, seja com um operador de inserção sobrecarregado ou com a Serialize função membro, cada elemento é serializado por sua vez.

Observação

Antes de usar um array, use SetSize para determinar o seu tamanho e alocar memória para ele. Se não usar SetSize, adicionar elementos ao seu array faz com que este seja frequentemente realocado e copiado. A realocação e cópia frequentes são ineficientes e podem fragmentar a memória.

Se precisar de um dump de elementos individuais da string no array, deve definir a profundidade do contexto do dump para 1 ou superior.

Quando um CString array é eliminado, ou quando os seus elementos são removidos, a memória das strings é libertada conforme apropriado.

Para mais informações sobre a utilização CStringArrayde , consulte o artigo Coleções.

Hierarquia de herança

CObject

CStringArray

Requerimentos

Cabeçalho:afxcoll.h

Consulte também

CObject Classe
Gráfico de Hierarquia