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 AddHead( CObject* newElement )
  throw( CMemoryException );
  void AddHead( 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 head 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.AddHead( new CAge( 21 ) ); // 21 is now at head
     list.AddHead( new CAge( 40 ) ); // 40 replaces 21 at head
  #ifdef _DEBUG
     afxDump.SetDepth( 1 );
     afxDump << "AddHead example: " << &list << "\n";
  #endif
 
  The results from this program are as follows:
 
  AddHead example: A CObList with 2 elements
      a CAge at $44A8 40
      a CAge at $442A 21
 
  See Also
 
  ◄CObList::GetHead►, ◄CObList::RemoveHead►
 
 
                                     -♦-