/*------------------------------------------------------------------*/
/* list.h (Version 1: Fundamentals)                                 */
/*------------------------------------------------------------------*/

#ifndef LIST_INCLUDED
#define LIST_INCLUDED

typedef struct List *List_T;

extern List_T List_new();
extern void List_free(List_T oList);

extern unsigned long List_length(List_T oList);

extern void *List_getFirst(List_T oList);
extern void *List_getLast(List_T oList);

extern void List_addFirst(List_T oList, void *pvItem);
extern void List_addLast(List_T oList, void *pvItem);

extern void List_removeFirst(List_T oList);
extern void List_removeLast(List_T oList);

extern void List_toArray(List_T oList, void **ppvArray);

extern void List_map(List_T oList, 
                     void (*pfApply)(void **ppvItem, void *pvExtra),
                     void *pvExtra);

#endif