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 CArray | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;GetUpperBound, CArray::SetAt, CArray::RemoveAt