Classe CWordArray

Dá suporte a matrizes de palavras de 16 bits.

Sintaxe

class CWordArray : public CObject

Membros

As funções de membro de CWordArray 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 de CObject como um parâmetro de função ou valor retornado, substitua um WORD.

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

por exemplo, traduz para

WORD CWordArray::GetAt( int <nIndex> ) const;

Construtores públicos

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

Métodos públicos

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

Operadores públicos

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

Comentários

A CWordArray incorpora a macro IMPLEMENT_SERIAL para dar suporte para serialização e despejo de seus elementos. Se uma matriz de palavras for armazenada em um arquivo, com um operador de inserção sobrecarregado ou com a função de membro CObject::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 individuais na matriz, será necessário definir a profundidade do contexto do despejo para 1 ou maior.

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

Hierarquia de herança

CObject

CWordArray

Requisitos

Cabeçalho: afxcoll.h

Confira também

COLLECT de amostra MFC
Classe CObject
Gráfico da hierarquia