CArray::InsertAt

Artigo
08/25/2010

A primeira versão do InsertAt Insere um elemento (ou várias cópias de um elemento) em um índice especificado em uma matriz.

void InsertAt(
   INT_PTR nIndex,
      ARG_TYPE newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CArray* pNewArray 
);

Parâmetros

nIndex
Um índice de inteiro pode ser maior que o valor retornado por GetUpperBound.
ARG_TYPE
Parâmetro do modelo especifica o tipo de elementos nesta matriz.
newElement
O elemento sejam colocados nessa matriz.
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

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 CArray 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.

Exemplo

// example for CArray::InsertAt

CArray<CPoint,CPoint> ptArray;

ptArray.Add(CPoint(10,20));   // Element 0
ptArray.Add(CPoint(30,40));   // Element 1 (will become element 2)
ptArray.InsertAt(1, CPoint(50,60));   // New element 1