Partilhar via


Classe CDWordArray

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 duplas de 32 bits.

Sintaxe

class CDWordArray : public CObject

Membros

As funções membros de CDWordArray 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 parâmetro de função ou valor de retorno, substitua um DWORD.

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

por exemplo, traduz-se em

DWORD CDWordArray::GetAt( int <nIndex> ) const;

Construtores Públicos

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

Métodos Públicos

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

Operadores Públicos

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

Observações

CDWordArray incorpora a IMPLEMENT_SERIAL macro para suportar a serialização e o despejo dos seus elementos. Se um array de palavras duplas for armazenado num arquivo, seja com o operador de inserção sobrecarregada ( <<) ou com a Serialize função membro, 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 saída de depuração a partir de elementos individuais no array, deve definir a profundidade do CDumpContext objeto para 1 ou superior.

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

Requerimentos

Cabeçalho: afxcoll.h

Consulte também

Classe CObject
Gráfico de Hierarquia
Classe CObArray