void InsertAt ( int nIndex, CObject * newElement, int nCount = 1 );
tirar ( CMemoryException );
void InsertAt ( int nStartIndex, CObArray * pNewArray );
tirar ( CMemoryException );
Parámetros
nIndex
Un índice de entero que puede ser mayor que el valor devuelto por GetUpperBound.
newElement
El puntero de CObject para colocarse en esta matriz. Se permite un newElement de valor NULL.
nCount
El número de veces que este elemento debe ser insertada (1 de forma predeterminada).
nStartIndex
Un índice de entero que puede ser mayor que el valor devuelto por GetUpperBound.
pNewArray
Otra matriz que contiene los elementos que se agregará a esta matriz.
Observaciones
La primera versión de InsertAt inserta un elemento (o copias múltiples de un elemento) en un índice especificado en una matriz. En el proceso, desplaza (incrementando el índice) el elemento existente de este índice y se desplaza hasta todos los elementos arriba.
La segunda versión inserta todos los elementos de otra colección de CObArray , comenzando en la posición de nStartIndex.
La función de SetAt , en cambio, sustituye un elemento de la matriz especificada y desplazar los elementos.
La siguiente tabla muestra otras funciones miembro que son similares a CObArray::InsertAt.
| Clase | Función miembro |
| CByteArray | a&nular InsertAt (int nIndex, BYTE newElement, int nCount=1); nbsp;tirar ( CMemoryException );
anular InsertAt (int nStartIndex, CByteArray * p&NewArray ); |
| CDWordArray | a&nular InsertAt (int nIndex, DWORD newElement, int nCount=1); nbsp;tirar ( CMemoryException );
anular InsertAt (int nStartIndex, CDWordArray * p&NewArray ); |
| CPtrArray | a&nular InsertAt (int nIndex, void * newElement, int nCount=1); nbsp;tirar ( CMemoryException );
anular InsertAt (int nStartIndex, CPtrArray * p&NewArray ); |
| CStringArray | a&nular InsertAt (int nIndex, LPCTSTR newElement, int nCount=1); nbsp;tirar ( CMemoryException );
anular InsertAt (int nStartIndex, CStringArray * p&NewArray ); |
| CUIntArray | anular InsertAt (int nIndex, UI&NT newElement, int nCount=1); nbsp;tirar ( CMemoryException );
anular InsertAt (int nStartIndex, CUIntArray * p&NewArray ); |
| CWordArray | a&nular InsertAt (int nIndex, WORD newElement, int nCount=1); nbsp;tirar ( CMemoryException );
anular InsertAt (int nStartIndex, CWordArray * p&NewArray ); |
Ejemplo
Consulte CObList::CObList para obtener una lista de los CAge clase utilizada en todos los ejemplos de colección.
/ / ejemplo de CObArray::InsertAt
nbsp; Matriz de CObArray;
arreglo de discos.Agregar (Nueva jaula (21)); / / Elemento 0
arreglo de discos.Agregar (Nueva jaula (40)); / / Elemento 1 (se convertirá en 2).
arreglo de discos.InsertAt (1, Nueva jaula (30)); / / Nuevo elemento 1
# ifdef _DEBUG
afxDump.SetDepth (1);
afxDump << "InsertAt ejemplo:" << & matriz << "\n";
# endif
Los resultados de este programa son los siguientes:
I&nsertAt ejemplo: un CObArray con 3 elementos
nbsp; [0] = una jaula a 45 ° C 8 21
[1] = una jaula en $4646 30
[2] = una jaula en 4606 $ 40
Visió&n General de CObArray |nbsp; Miembros de clase | Diagrama de jerarquía
Vea tambié&nnbsp;CObArray::SetAt, CObArray::RemoveAt