Classe CSimpleArray

Essa classe fornece métodos para gerenciar uma matriz simples.

Sintaxe

template <class T, class TEqual = CSimpleArrayEqualHelper<T>>
class CSimpleArray

Parâmetros

T
O tipo de dados a serem armazenados na matriz.

TEqual
Um objeto de característica, definindo o teste de igualdade para elementos do tipo T.

Membros

Construtores públicos

Nome	Descrição
CSimpleArray::CSimpleArray	O construtor da matriz simples.
CSimpleArray::~CSimpleArray	O destruidor da matriz simples.

Métodos públicos

Nome	Descrição
CSimpleArray::Add	Adiciona um novo elemento à matriz.
CSimpleArray::Find	Encontra um elemento na matriz.
CSimpleArray::GetData	Retorna um ponteiro para os dados armazenados em uma matriz.
CSimpleArray::GetSize	Retorna o número de elementos armazenados na matriz.
CSimpleArray::Remove	Remove um determinado elemento da matriz.
CSimpleArray::RemoveAll	Remove todos os elementos da matriz.
CSimpleArray::RemoveAt	Remove o elemento especificado da matriz.
CSimpleArray::SetAtIndex	Define o elemento especificado na matriz.

Operadores públicos

Nome	Descrição
CSimpleArray::operator[]	Recupera um elemento da matriz.
CSimpleArray::operator =	Operador de atribuição.

Comentários

CSimpleArray fornece métodos para criar e gerenciar uma matriz simples, de qualquer tipo T determinado.

O parâmetro TEqual fornece um meio de definir uma função de igualdade para dois elementos do tipo T. Ao criar uma classe semelhante a CSimpleArrayEqualHelper, é possível alterar o comportamento do teste de igualdade para qualquer determinada matriz. Por exemplo, ao lidar com uma matriz de ponteiros, pode ser útil definir a igualdade como dependendo dos valores que os ponteiros referenciam. A implementação padrão utiliza operator=().

O CSimpleArray e o CSimpleMap foram projetados para um pequeno número de elementos. CAtlArray e CAtlMap devem ser usados quando a matriz contém um grande número de elementos.

Requisitos

Cabeçalho: atlsimpcoll.h

Exemplo

// Create an array of integers
CSimpleArray<int> iArray;

// Create an array of char pointers
// and use a new equality function
CSimpleArray<char *, MyEqualityEqualHelper<char *> > cMyArray;   

CSimpleArray::Add

Adiciona um novo elemento à matriz.

BOOL Add(const T& t);

Parâmetros

t
O elemento a ser adicionado à matriz.

Valor de Devolução

Retornará TRUE se o elemento for adicionado com êxito à matriz. Caso contrário, FALSE.

Exemplo

// Create an array of integers and add some elements
CSimpleArray<int> iMyArray;
for (int i = 0; i < 10; i++)
   iMyArray.Add(i);  

CSimpleArray::CSimpleArray

O construtor do objeto da matriz.

CSimpleArray(const CSimpleArray<T, TEqual>& src);
CSimpleArray();

Parâmetros

src
Um objeto CSimpleArray existente.

Comentários

Inicializa os membros de dados, criando um objeto vazio CSimpleArray ou uma cópia de um objeto CSimpleArray existente.

CSimpleArray::~CSimpleArray

O destruidor.

~CSimpleArray();

Comentários

Libera todos os recursos alocados.

CSimpleArray::Find

Encontra um elemento na matriz.

int Find(const T& t) const;

Parâmetros

t
O elemento pelo qual pesquisar.

Valor de Devolução

Retornará o índice do elemento encontrado ou -1 se o elemento não for encontrado.

Exemplo

// Create an array of floats and search for a particular element

CSimpleArray<float> fMyArray;

for (int i = 0; i < 10; i++)
   fMyArray.Add((float)i * 100);

int e = fMyArray.Find(200);
if (e == -1)
   _tprintf_s(_T("Could not find element\n"));
else
   _tprintf_s(_T("Found the element at location %d\n"), e);   

CSimpleArray::GetData

Retorna um ponteiro para os dados armazenados em uma matriz.

T* GetData() const;

Valor de Devolução

Retorna um ponteiro para os dados na matriz.

CSimpleArray::GetSize

Retorna o número de elementos armazenados na matriz.

int GetSize() const;

Valor de Devolução

Retorna o número de elementos armazenados na matriz.

CSimpleArray::operator []

Recupera um elemento da matriz.

T& operator[](int nindex);

Parâmetros

nIndex
O índice do elemento.

Valor de Devolução

Retorna o elemento da matriz referenciada por nIndex.

Exemplo

// Create an array and display its contents
 CSimpleArray<int> iMySampleArray;

 for (int i = 0; i < 10; i++)
    iMySampleArray.Add(i);

 for (int i = 0; i < iMySampleArray.GetSize(); i++)
    _tprintf_s(_T("Array index %d contains %d\n"), i, iMySampleArray[i]);

CSimpleArray::operator =

Operador de atribuição.

CSimpleArray<T, TEqual>
& operator=(
    const CSimpleArray<T, TEqual>& src);

Parâmetros

src
A matriz a ser copiada.

Valor de Devolução

Retorna um ponteiro para o objeto CSimpleArray atualizado.

Comentários

Copia todos os elementos do objeto CSimpleArray referenciado pelo src no objeto de matriz atual, substituindo todos os dados existentes.

Exemplo

// Create an array of chars and copy it to a second array
CSimpleArray<char> cMyArray1;
cMyArray1.Add('a');
CSimpleArray<char> cMyArray2;
cMyArray2 = cMyArray1;
ATLASSERT(cMyArray2[0] == 'a');   

CSimpleArray::Remove

Remove um determinado elemento da matriz.

BOOL Remove(const T& t);

Parâmetros

t
O elemento a ser removido da matriz.

Valor de Devolução

Retorna TRUE se o elemento é encontrado e removido. Caso contrário, FALSE.

Comentários

Quando um elemento é removido, os elementos restantes na matriz são renumerados para preencher o espaço vazio.

CSimpleArray::RemoveAll

Remove todos os elementos da matriz.

void RemoveAll();

Comentários

Remove todos os elementos armazenados atualmente na matriz.

CSimpleArray::RemoveAt

Remove o elemento especificado da matriz.

BOOL RemoveAtint nIndex);

Parâmetros

nIndex
Índice apontando para o elemento a ser removido.

Valor de Devolução

Retornará TRUE se o elemento tiver sido removido, FALSE se o índice for inválido.

Comentários

Quando um elemento é removido, os elementos restantes na matriz são renumerados para preencher o espaço vazio.

CSimpleArray::SetAtIndex

Define o elemento especificado na matriz.

BOOL SetAtIndex(
    int nIndex,
    const T& t);

Parâmetros

nIndex
O índice do elemento a ser alterado.

t
O valor a ser atribuído ao elemento especificado.

Valor de Devolução

Retornará TRUE se tiver êxito, FALSE se o índice não for válido.

Confira também

Visão geral da classe