ret_tag.i4.v = put(aList.s.r, item.g.r, size.i4.v, tag.i4.v)
This method appends an element to the tail of the aList.
The aList 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 "put" into the aList.
aList a pointer to the aList (structure of type aList)
item a pointer (of any type) to the item to be stored
size the size of the item (in bytes)
tag a unique (across the invocation of the program)
tag which can be used for the retrieval of this
This function returns:
an integer tag which can be used for subsequent pseudo-random
retrieval of the item stored in the aList. This is the same tag
that was passed as an argument.
Use of this class requires the following header files:
create_aList() the constructor for instances of the aList class
ret_tag = (*aList->put)(aList,(void *) &item,sizeof(item),tag);