list_create function <BLOC/list.h>
The list_create function creates a list object. A list can have an associated type of object, or it can be for any object type. This can be specified when creating the list.
Syntax
List * list_create( struct ObjectType *type );
Parameters
type
A pointer to an ObjectType structure describing the type of object allowed in the list.
If NULL, the list will accept objects of any type.
Return value
A reference pointer to the newly created List object.