Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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 arrays de palavras de 16 bits.
Sintaxe
class CWordArray : public CObject
Membros
As funções membros de CWordArray 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 ponteiro CObject como parâmetro de função ou valor de retorno, substitua por WORD.
CObject* CObArray::GetAt( int <nIndex> ) const;
por exemplo, traduz-se em
WORD CWordArray::GetAt( int <nIndex> ) const;
Construtores Públicos
| Nome | Description |
|---|---|
| CWordArray::CWordArray | Constrói um array vazio. |
Métodos Públicos
| Nome | Description |
|---|---|
| CWordArray::Add | Adiciona um elemento ao final do array; Cresce a matriz se necessário. |
| CWordArray::Anexar | Adiciona outro array ao array; Cresce a matriz se necessário. |
| CWordArray::Copiado | Copia outro array para o array; Cresce a matriz se necessário. |
| CWordArray::ElementAt | Devolve uma referência temporária ao ponteiro de elemento dentro do array. |
| CWordArray::FreeExtra | Liberta toda a memória não utilizada acima do limite superior atual. |
| CWordArray::GetAt | Devolve o valor num dado índice. |
| CWordArray::GetCount | Obtém o número de elementos neste array. |
| CWordArray::GetData | Permite o acesso a elementos no array. Pode ser NULL. |
| CWordArray::GetSize | Obtém o número de elementos neste array. |
| CWordArray::GetUpperBound | Devolve o maior índice válido. |
| CWordArray::InsertAt | Insere um elemento (ou todos os elementos de outro array) num índice especificado. |
| CWordArray::IsEmpty | Determina se o array está vazio. |
| CWordArray::RemoveAll | Remove todos os elementos deste array. |
| CWordArray::RemoveAt | Remove um elemento num índice específico. |
| CWordArray::SetAt | Define o valor para um dado índice; Array não pode crescer. |
| CWordArray::SetAtGrow | Define o valor para um dado índice; Cresce a matriz se necessário. |
| CWordArray::SetSize | Define o número de elementos a serem contidos neste arranjo. |
Operadores Públicos
| Nome | Description |
|---|---|
CWordArray::operator[] |
Define ou obtém o elemento no índice especificado. |
Observações
CWordArray incorpora a macro IMPLEMENT_SERIAL para suportar a serialização e o despejo dos seus elementos. Se um array de palavras for armazenado num arquivo, seja com um operador de inserção sobrecarregado ou com a função membro CObject::Serialize , cada elemento é, por sua vez, serializado.
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 no array, deve definir a profundidade do contexto do dump para 1 ou superior.
Para mais informações sobre a utilização CWordArrayde , consulte o artigo Coleções.
Hierarquia de herança
CWordArray
Requerimentos
Cabeçalho: afxcoll.h