CObArray::InsertAt

Insere um elemento (ou todos os elementos em outro array) em um índice especificado.

void InsertAt(
   INT_PTR nIndex,
   CObject* newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CObArray* pNewArray 
);

Parâmetros

• nIndex
  Um índice de inteiro pode ser maior que o valor retornado por GetUpperBound.

• newElement
  The CObject ponteiro sejam colocados nessa matriz. A newElement de valor NULO é permitido.

• nCount
  O número de vezes que esse elemento deve ser inserida (padrões para 1).

• nStartIndex
  Um índice de inteiro pode ser maior que o valor retornado por GetUpperBound.

• pNewArray
  Outra matriz que contém elementos a serem adicionados a essa matriz.

Comentários

A primeira versão do InsertAt Insere um elemento (ou várias cópias de um elemento) em um índice especificado em uma matriz. No processo, ele alterna (aumentando o índice) do elemento existente neste índice e desloca todos os elementos acima dela.

A segunda versão insere todos os elementos do outro CObArray coleção, começando com o nStartIndex posição.

The SetAt função, por outro lado, substitui um elemento de matriz especificada e não deslocar quaisquer elementos.

A tabela a seguir mostra outras funções de membro semelhantes a CObArray::InsertAt.

Exemplo

See CObList::CObList para obter uma lista do CAge classe usada em todos os exemplos de coleção.

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1 (will become 2).
arr.InsertAt(1, new CAge(30));  // New element 1
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("InsertAt example: ") << &arr << _T("\n");
#endif      

sistema autônomo resultados deste programa são da seguinte maneira:

InsertAt example: A CObArray with 3 elements

[0] = a CAge at $45C8 21

[1] = a CAge at $4646 30

[2] = a CAge at $4606 40

Requisitos

Cabeçalho: afxcoll.h

Consulte também

Referência

Classe CObArray

Gráfico de hierarquia

CObArray::SetAt

CObArray::RemoveAt

Outros recursos

CObArray membros