CArray::InsertAt

privatevoid InsertAt ( int nIndex, ARG_TYPE newElement, int nCount = 1 );
lançar ( CMemoryException );

privatevoid InsertAt ( int nStartIndex, CArray * pNewArray );
lançar ( CMemoryException );

Parâmetros

nIndex

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

ARG_TYPE

Parâmetro do modelo especificando o tipo de elementos nessa matriz.

newElement

O elemento a ser colocado nessa matriz.

nCount

O número de vezes que este elemento deve ser inserido (padrão é 1).

nStartIndex

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

pNewArray

Outra matriz que contém elementos a ser adicionado a essa matriz.

Observações

A primeira versão do InsertAt insere um elemento (ou Múltiplo cópias de um elemento) em um índice especificado em uma matriz. No processo, ele alterna (por incrementar o índice) do elemento existente a este índice e desloca todos os elementos acima dela.

O segundo versão insere Tudo elementos de outro conjunto de CArray , começando na posição nStartIndex.

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

Exemplo

/ / exemplo de CArray::InsertAt

CArraylt;CPoint, CPoint > ptArray;

ptArray.Add(CPoint(10,20));   / / Elemento 0
ptArray.Add(CPoint(30,40));   / / Elemento 1 (vai se tornar elemento 2)
ptArray.InsertAt (1, CPoint(50,60));   / / Novo elemento 1

Visão geral de CArrayMembros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;GetUpperBound, CArray::SetAt, CArray::RemoveAt

Index