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 ); |
CDWordArray | void I&nsertAt (int nIndex, DWORD newElement, int nCount=1); nbsp;lançar ( CMemoryException );
void InsertAt (int nStartIndex, CDWordArray * p&NewArray ); |
CPtrArray | void I&nsertAt (int nIndex, void * newElement, int nCount=1); nbsp;lançar ( CMemoryException );
void InsertAt (int nStartIndex, CPtrArray * p&NewArray ); |
CStringArray | void I&nsertAt (int nIndex, LPCTSTR newElement, int nCount=1); nbsp;lançar ( CMemoryException );
void InsertAt (int nStartIndex, CStringArray * p&NewArray ); |
CUIntArray | void InsertAt (int nIndex, UI&NT newElement, int nCount=1); nbsp;lançar ( CMemoryException );
void InsertAt (int nStartIndex, CUIntArray * p&NewArray ); |
CWordArray | void I&nsertAt (int nIndex, WORD newElement, int nCount=1); nbsp;lançar ( CMemoryException );
void InsertAt (int nStartIndex, CWordArray * p&NewArray ); |
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 CObArray | Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;CObArray:: SetAt, CObArray::RemoveAt