new_tag.i4.v = insert_after_element(list.s.r, item.g.r, size.i4.v,
This method inserts an element immediately after the specified element.
If the specified element is greater than the number of elements, the
new node is appended at the tail. Elements are numbered beginning at
one, so that specifying element zero causes the new element to be
prepended at the head.
The List class actually allocates new space in which to store
the data item, and makes its own copy of it, so that the original
does not need to be kept after it has been inserted into the List.
list a pointer to the list (structure of type List)
item a pointer (of any type) to the item to be stored
size the size of the item (in bytes)
element_number the index into the List (or position in the List)
corresponding to the item after which the
new item is to be inserted into the List
This function returns:
an integer tag which can be used for subsequent pseudo-random
retrieval of the item stored in the List
Use of this class requires the following header files:
create_List() the constructor for instances of the List class
new_tag = (*list->insert_after_element)(list,(void*) &item,