CAtlList::AddTailList

 

Call this method to add an existing list to the tail of this list.

Syntax

      void AddTailList(
   const CAtlList< E, ETraits >* plNew 
);

Parameters

  • plNew
    The list to be added.

Remarks

The list pointed to by plNew is inserted after the last element (if any) in the list object. The last element in the plNew list therefore becomes the tail. In debug builds, an assertion failure will occur if plNew is equal to NULL.

Example

// Define two integer lists
CAtlList<int> myList1;
CAtlList<int> myList2;

// Fill up the first list
myList1.AddTail(1);
myList1.AddTail(2);
myList1.AddTail(3);

// Add an element to the second list
myList2.AddTail(4);

// Insert the first list into the second
myList2.AddTailList(&myList1);

// The second list now contains:
// 4, 1, 2, 3   

Requirements

Header: atlcoll.h

See Also

CAtlList Class
CAtlList::AddTail
CAtlList::AddHead