Partager via


CObArray::Add

Ajoute un élément à la fin d'un tableau, élevant tableau par 1.

INT_PTR Add( 
   CObject* newElement  
);

Paramètres

  • newElement
    Le pointeur d' CObject à ajouter à ce tableau.

Valeur de retour

L'index de l'élément ajouté.

Notes

Si SetSize a été utilisé avec une valeur d' nGrowBy supérieure à 1, la mémoire supplémentaire peut être allouée. Toutefois, la limite supérieure augmente de 1 uniquement.

Le tableau suivant indique les autres fonctions membres similaires à CObArray::Add.

Classe

Fonction membre

CByteArray

INT_PTR Add( BYTE newElement);

    jet (CMemoryException*) ;

CDWordArray

INT_PTR Add( DWORD newElement);

    jet (CMemoryException*) ;

CPtrArray

INT_PTR Add( void* newElement);

    jet (CMemoryException*) ;

CStringArray

INT_PTR Add( LPCTSTR newElement); jet (CMemoryException*) ;

INT_PTR Add(const CString& newElement);

CUIntArray

INT_PTR Add( UINT newElement);

    jet (CMemoryException*) ;

CWordArray

INT_PTR Add( WORD newElement);

    jet (CMemoryException*) ;

Exemple

Consultez CObList::CObList pour obtenir l'intégralité de la classe d' CAge utilisée dans les exemples de collection.

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("Add example: ") << &arr << _T("\n");
#endif      

Les résultats de ce programme sont les suivantes :

Add example: A CObArray with 2 elements

[0] = a CAge at $442A 21

[1] = a CAge at $4468 40

Configuration requise

Header: afxcoll.h

Voir aussi

Référence

CObArray, classe

Graphique de la hiérarchie

CObArray::SetAt

CObArray::SetAtGrow

CObArray::InsertAt

CObArray::operator []