CObArray::InsertAt

Artigo
08/25/2010

Insere um elemento (ou todos os elementos em outro array) em um índice especificado.

void InsertAt(
   INT_PTR nIndex,
   CObject* newElement,
   INT_PTR nCount = 1 
);
void InsertAt(
   INT_PTR nStartIndex,
   CObArray* pNewArray 
);

Parâmetros

nIndex
Um índice de inteiro pode ser maior que o valor retornado por GetUpperBound.
newElement
The CObject ponteiro sejam colocados nessa matriz. A newElement de valor NULO é permitido.
nCount
O número de vezes que esse elemento deve ser inserida (padrões para 1).
nStartIndex
Um índice de inteiro pode ser maior que o valor retornado por GetUpperBound.
pNewArray
Outra matriz que contém elementos a serem adicionados a essa matriz.

Comentários

A primeira versão do InsertAt Insere um elemento (ou várias cópias de um elemento) em um índice especificado em uma matriz. No processo, ele alterna (aumentando o índice) do elemento existente neste índice e desloca todos os elementos acima dela.

A segunda versão insere todos os elementos do outro CObArray coleção, começando com o nStartIndex posição.

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

A tabela a seguir mostra outras funções de membro semelhantes a CObArray::InsertAt.

Classe	Função de membro
CByteArray	void InsertAt( INT_PTR nIndex, BYTE newElement, int nCount = 1 ); *Lançar (CMemoryException ); void InsertAt (INT_PTR** nStartIndex, CByteArray* pNewArray ); *Lançar (CMemoryException );**
CDWordArray	void InsertAt( INT_PTR nIndex, DWORD newElement, int nCount = 1 ); *Lançar (CMemoryException ); void InsertAt (INT_PTR** nStartIndex, CDWordArray* pNewArray ); *Lançar (CMemoryException );**
CPtrArray	void InsertAt( INT_PTR nIndex, void* newElement, int nCount = 1 ); *Lançar (CMemoryException ); void InsertAt (INT_PTR** nStartIndex, CPtrArray* pNewArray ); *Lançar (CMemoryException );**
CStringArray	void InsertAt( INT_PTR nIndex, LPCTSTR newElement, int nCount = 1 ); *Lançar (CMemoryException ); void InsertAt (INT_PTR nStartIndex, pNewArray CStringArray );* *Lançar (CMemoryException );**
CUIntArray	void InsertAt( INT_PTR nIndex, UINT newElement, int nCount = 1 ); *Lançar (CMemoryException ); void InsertAt (INT_PTR** nStartIndex, CUIntArray* pNewArray ); *Lançar (CMemoryException );**
CWordArray	void InsertAt( INT_PTR nIndex, WORD newElement, int nCount = 1 ); *Lançar (CMemoryException ); void InsertAt (INT_PTR** nStartIndex, CWordArray* pNewArray ); *Lançar (CMemoryException );**

Exemplo

See CObList::CObList para obter uma lista do CAge classe usada em todos os exemplos de coleção.

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1 (will become 2).
arr.InsertAt(1, new CAge(30));  // New element 1
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("InsertAt example: ") << &arr << _T("\n");
#endif

sistema autônomo resultados deste programa são da seguinte maneira:

InsertAt example: A CObArray with 3 elements

[0] = a CAge at $45C8 21

[1] = a CAge at $4646 30

[2] = a CAge at $4606 40