Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄CObList►                                     ◄Up► ◄Contents► ◄Index► ◄Back►
──Microsoft Foundation Classes──────────────────────────────────────────────
 
  POSITION AddTail( CObject* newElement )
  throw( CMemoryException );
  void AddTail( CObList* pNewList )
  throw( CMemoryException );
 
  Parameter    Description
 
  <newElement> The CObject pointer to be added to this list.
 
  <pNewList>   A pointer to another CObList list. The elements in
               <pNewList> will be added to this list.
 
  Remarks
 
  Adds a new element or list of elements to the tail of this list. The
  list may be empty before the operation.
 
  Return Value
 
  The first version returns the POSITION value of the newly inserted
  element.
 
  Example
 
     CObList list;
     list.AddTail( new CAge( 21 ) );
     list.AddTail( new CAge( 40 ) ); // List now contains (21, 40)
  #ifdef _DEBUG
     afxDump.SetDepth( 1 );
     afxDump << "AddTail example: " << &list << "\n";
  #endif
 
  The results from this program are as follows:
 
  AddTail example: A CObList with 2 elements
       a CAge at $444A 21
       a CAge at $4526 40
 
  See Also
 
  ◄CObList::GetTail►, ◄CObList::RemoveTail►
 
 
                                     -♦-