CList::SetAt

A variable of type POSITION is a key for the list.

void SetAt(
   POSITION pos,
      ARG_TYPE newElement 
);

Parameters

• pos
  The POSITION of the element to be set.

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

• newElement
  The element to be added to the list.

Remarks

It is not the same as an index, and you cannot operate on a POSITION value yourself. SetAt writes the element to the specified position in the list.

You must ensure that your POSITION value represents a valid position in the list. If it is invalid, then the Debug version of the Microsoft Foundation Class Library asserts.

Example

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

// Add three elements to the list.
myList.AddTail(CString(_T("XYZ")));
myList.AddTail(CString(_T("ABC")));
myList.AddTail(CString(_T("123")));

// Replace CString("ABC") with CString("CBA")
POSITION pos = myList.Find(CString(_T("ABC")));
myList.SetAt(pos, CString(_T("CBA")));

// Verify CString("ABC") is not in the list.
ASSERT(myList.Find(CString(_T("ABC"))) == NULL);      

Requirements

Header: afxtempl.h

See Also

Concepts

CList Class

CList Members

Hierarchy Chart

CList::Find

CList::GetAt

CList::GetNext

CList::GetPrev