Classe de CStringArray

Artigo
02/25/2013

Suporta matrizes de objetos de CString .

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 similaridade, você pode usar a documentação de referência de CObArray para específicos da função de membro.Onde quer que você verá um ponteiro de CObject como um valor de retorno, substitua CString (não um ponteiro de CString ).Onde quer que você verá um ponteiro de CObject como um parâmetro de função, substitua LPCTSTR.

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

por exemplo, converte a

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

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

converte a

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

Construtores public

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

Métodos públicos

Nome	Descrição
CObArray::Add	Adiciona um elemento ao final da matriz; aumenta a matriz se necessário.
CObArray::Append	Acrescenta uma matriz a outra matriz; aumenta a matriz se necessário.
CObArray::Copy	Copia uma matriz a outra matriz; aumenta a matriz se necessário.
CObArray::ElementAt	Retorna uma referência temporária ao ponteiro de elemento dentro da matriz.
CObArray::FreeExtra	Qualquer libera a memória não usado acima do limite superior atual.
CObArray::GetAt	Retorna o valor em um índice especificado.
CObArray::GetCount	Obtém o número de elementos em esta matriz.
CObArray::GetData	Permite acesso aos elementos na matriz.Pode ser NULO.
CObArray::GetSize	Obtém o número de elementos em esta matriz.
CObArray::GetUpperBound	Retorna o índice válido maior.
CObArray::InsertAt	Insere elemento (ou todos os elementos em outros matriz) em um índice especificado.
CObArray::IsEmpty	Determina se a matriz está vazia.
CObArray::RemoveAll	Remove todos os elementos da matriz.
CObArray::RemoveAt	Remove um elemento em um índice específico.
CObArray::SetAt	Defina o valor para um índice dado; matriz não permitida crescer.
CObArray::SetAtGrow	Defina o valor para um índice dado; aumenta a matriz se necessário.
CObArray::SetSize	Define o número de elementos a serem contidos em esta matriz.

Operadores públicos

Nome	Descrição
CObArray::operator [ ]	Obtém ou define o elemento no índice especificado.

Comentários

CStringArray inserir a macro de IMPLEMENT_SERIAL para oferecer suporte a serialização e a despejo de seus elementos.Se uma matriz de objetos de CString é armazenada em um arquivo, com um operador sobrecarregado insert ou com a função de membro de Serialize , cada elemento é serializado por sua vez.

Observação
Antes de usar uma matriz, use SetSize para estabelecer o tamanho e atribuir a memória para ele.Se você não usar SetSize, adicione os elementos a sua matriz freqüentemente faz com que ele manipule a ser realocada e copiado.A realocação freqüentes e copiar e são não podem fragmentar a memória.

Se você precisar de um despejo dos elementos individuais de cadeia de caracteres na matriz, você deve definir o tamanho do contexto de um despejo a 1 ou maior.

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

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

Hierarquia de herança

CObject

CStringArray

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe de CObject

Gráfico de hierarquia

Compartilhar via