CArray::InsertAt

Artigo
02/25/2013

A primeira versão de 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 inteiro que pode ser maior que o valor retornado por GetUpperBound.
ARG_TYPE
Parâmetros de modelo que especifica o tipo de elementos no array.
newElement
O elemento a ser colocado em esta matriz.
nCount
O número de vezes que esse elemento deve ser inserido (o padrão é 1).
nStartIndex
Um índice inteiro que pode ser maior que o valor retornado por GetUpperBound.
pNewArray
Outra matriz que contém os elementos a serem adicionados à matriz.

Comentários

Em o processo, desloca anterior (incremento) do índice elemento existente no índice, e desloca acima de todos os elementos acima.

A segunda versão inserir todos os elementos de outra coleção de CArray , começando na posição de nStartIndex .

A função de SetAt , por outro lado, substitui um elemento de matriz especificado e não muda 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