create_List (ul_oocbs)

	list.s.r = create_List()

	This function is used as a constructor to create an instance of
	the List class. This class is used to provide an object-oriented
	interface to a heterogenous list datatype.

	This function returns:

	a pointer to the newly-created instance of the List class upon
	success, or a null pointer upon failure to allocate virtual memory.

	Use of this class requires the following header files:

	list.h

	Methods for List:

	destroy           destructor for the List class
	free              used to tell an instance of the List class to free
	                  all of the virtual memory it has allocated. This is
	                  primarily provided to support derived classes; most
	                  application programs should NOT call this method.
	                  Only use this method if you really know what you are
	                  doing.
	clone             used to clone an instance of a List class, to make
	                  another identical instance of a List class, including
	                  all data. This method does its own allocation and
	                  copying of all stored data items, so the cloned List
	                  is truly independent of the List from which it was
	                  created.
	put               insert an item at the tail of the List
	get               remove an item from the head of the List
	get_length        find out how many items are stored in the List
	retrieve          retrieve a copy the item specified by the given tag,
	                  leaving the original item in the List
	retrieve_last     retrieve a copy the item specified by the given tag,
	                  leaving the original item in the List
	remove            remove the item specified by the given tag
	insert_after_tag  insert an item into the list after the item
	                  corresponding to the specified tag
	insert_after_element insert an item into the list after the item
	                  with the specified position in the list
	update            change the value of the item with the specified tag
	reset             reset the List's internal iteration pointer to
	                  point to the beginning of the List
	get_next          remove the "next" item from the list

	C/C++ usage:

	#include "list.h"
	List*	list;

	list = create_List();