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
CWordArray
Requisitos
Cabeçalho: afxcoll.h