CList::AddTail

Adds a new element or list of elements to the tail of this list.

POSITION AddTail(
   ARG_TYPE newElement 
);
void AddTail(
   CList* pNewList 
);

Parameters

  • ARG_TYPE
    Template parameter specifying the type of the list element (can be a reference).

  • newElement
    The element to be added to this list.

  • pNewList
    A pointer to another CList list. The elements in pNewList will be added to this list.

Return Value

The first version returns the POSITION value of the newly inserted element.

Remarks

The list can be empty before the operation.

Example

// Define myList and myList2.
CList<CString,CString&> myList;
CList<CString,CString&> myList2;

// Add elements to the end of myList and myList2.
myList.AddTail(CString(_T("A")));
myList.AddTail(CString(_T("B")));
myList2.AddTail(CString(_T("C")));
myList2.AddTail(CString(_T("D")));

// There are two versions of CList::AddTail: one adds a single
// element to the end of the list, the second adds another list
// to the end. 

// This adds the string "ABC" to the end of myList.
// myList is a list of CStrings (ie defined as CList<CString,CString&>).
myList.AddTail(CString(_T("ABC")));
ASSERT(CString(_T("ABC")) == myList.GetTail());

// This adds the elements of myList2 to the end of myList.
myList.AddTail(&myList2);

Requirements

Header: afxtempl.h

See Also

Reference

CList Class

Hierarchy Chart

CObList::GetTail

CObList::RemoveTail

Other Resources

CList Members