Classe CDWordArray
Dá suporte a matrizes de palavras duplas de 32 bits.
Sintaxe
class CDWordArray : public CObject
Membros
As funções de membro de CDWordArray 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, substitua um DWORD.
CObject* CObArray::GetAt( int <nIndex> ) const;
por exemplo, traduz para
DWORD CDWordArray::GetAt( int <nIndex> ) const;
Construtores públicos
| Nome | Descrição |
|---|---|
| CDWordArray::CDWordArray | Constrói uma matriz vazia. |
Métodos públicos
| Nome | Descrição |
|---|---|
| CDWordArray::Add | Inclui um elemento ao final da matriz; aumenta a matriz quando necessário. |
| CDWordArray::Append | Acrescenta outra matriz à matriz; aumenta a matriz quando necessário. |
| CDWordArray::Copy | Copia outra matriz à matriz; aumenta a matriz quando necessário. |
| CDWordArray::ElementAt | Retorna uma referência temporária ao ponteiro do elemento dentro da matriz. |
| CDWordArray::FreeExtra | Libera toda memória não usada acima do limite superior atual. |
| CDWordArray::GetAt | Retorna o valor a um determinado índice. |
| CDWordArray::GetCount | Obtém o número de elementos nesta matriz. |
| CDWordArray::GetData | Permite acesso aos elementos na matriz. Pode ser NULL. |
| CDWordArray::GetSize | Obtém o número de elementos nesta matriz. |
| CDWordArray::GetUpperBound | Retorna o maior índice válido. |
| CDWordArray::InsertAt | Insere um elemento (ou todos os elementos em outra matriz) em um índice especificado. |
| CDWordArray::IsEmpty | Determina se a matriz está vazia. |
| CDWordArray::RemoveAll | Remove todos os elementos dessa matriz. |
| CDWordArray::RemoveAt | Remove um elemento a um índice específico. |
| CDWordArray::SetAt | Define o valor de um determinado índice; não é permitido à matriz aumentar. |
| CDWordArray::SetAtGrow | Define o valor de um determinado índice; aumenta a matriz quando necessário. |
| CDWordArray::SetSize | Define o número de elementos a ser contido nesta matriz. |
Operadores públicos
| Nome | Descrição |
|---|---|
| CDWordArray::operator [ ] | Define ou obtém o elemento no índice especificado. |
Comentários
A CDWordArray incorpora a macro IMPLEMENT_SERIAL para suportar serialização e despejo de seus elementos. Se uma matriz de palavras duplas for armazenada em um arquivo, com um operador de inserção sobrecarregado ( <<) ou com a função de membro 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 depurar a saída a partir de elementos individuais na matriz, será necessário definir a profundidade objetoCDumpContext para 1 ou mais.
Para mais informações sobre como usar CDWordArray, confira o artigo Coleções.
Requisitos
Cabeçalho: afxcoll.h