CObArray:: InsertAt

privatevoidInsertAt (intnIndex,CObjectnewElement,intnCount=1);
lançar ( CMemoryException );

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

Parâmetros

nIndex

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

newElement

O ponteiro de CObject sejam colocados nessa matriz. Um newElement de valor NULL é permitido.

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 outra coleção CObArray , 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.

A tabela a seguir mostra Outro funções de membro que são semelhantes às CObArray:: InsertAt.

Classe Função de membro
CByteArray void I&nsertAt (int nIndex, BYTE newElement, int nCount=1);
nbsp;lançar ( CMemoryException );

void InsertAt (int nStartIndex, CByteArray * p&NewArray );
nbsp;lançar ( CMemoryException );

CDWordArray void I&nsertAt (int nIndex, DWORD newElement, int nCount=1);
nbsp;lançar ( CMemoryException );

void InsertAt (int nStartIndex, CDWordArray * p&NewArray );
nbsp;lançar ( CMemoryException );

CPtrArray void I&nsertAt (int nIndex, void * newElement, int nCount=1);
nbsp;lançar ( CMemoryException );

void InsertAt (int nStartIndex, CPtrArray * p&NewArray );
nbsp;lançar ( CMemoryException );

CStringArray void I&nsertAt (int nIndex, LPCTSTR newElement, int nCount=1);
nbsp;lançar ( CMemoryException );

void InsertAt (int nStartIndex, CStringArray * p&NewArray );
nbsp;lançar ( CMemoryException );

CUIntArray void InsertAt (int nIndex, UI&NT newElement, int nCount=1);
nbsp;lançar ( CMemoryException );

void InsertAt (int nStartIndex, CUIntArray * p&NewArray );
nbsp;lançar ( CMemoryException );

CWordArray void I&nsertAt (int nIndex, WORD newElement, int nCount=1);
nbsp;lançar ( CMemoryException );

void InsertAt (int nStartIndex, CWordArray * p&NewArray );
nbsp;lançar ( CMemoryException );


Exemplo

Consulte CObList:: CObList para obter uma listagem do CAge classe usada em tudo exemplos coleção.

/ / exemplo de CObArray:: InsertAt

nbsp;  CObArray matriz;
    
    matriz.Adicionar (nova gaiola (21)); / / Elemento 0
    matriz.Adicionar (nova gaiola (40)); / / Elemento 1 (tornará 2).
    matriz.InsertAt (1, Nova gaiola (30));  / / Novo elemento 1
# ifdef  Debug
    afxDump.SetDepth (1);
    afxDump << "InsertAt exemplo:" << & matriz << "\n";
# endif

Os resultados deste programa são os seguintes:

I&nsertAt exemplo: um CObArray com 3 elementos
 nbsp;  [0] = uma gaiola a 45 ° C de r $8 21
    [1] = uma gaiola em $4646 30
    [2] = uma gaiola em $4606 40

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

Co&nsulte tambémnbsp;CObArray:: SetAt, CObArray::RemoveAt

Index