List::InsertAfter

Defined in: C4List.h

Inserts an object after an existing element of a list.

Prototype

void InsertAfter(ListElement<type> *element, ListElement<type> *after);

Parameters

`element`	A pointer to the object to add to the list.
`after`	A pointer to the object after which the new object is inserted. This parameter must point to an object that is already a member of the list.

Description

The InsertAfter function adds the object specified by the element parameter to a list at the position after the object specified by the after parameter. If the object is already a member of the list, then it is moved to the new position. If the object is a member of a different list, then it is first removed from that list before being added to the new list.