When developing an application of any mangnitude there comes a time when you will need to deal with lists of data within your application. To this end GLIB provides some convient functions to handle both signly linked lists, and doubly linked lists. Facilities also exist for custom list handling if the basic lists don't suite your purpose. This chapter will cover the all the functions provided in GLIB for list management. Describe the list allocation functions... GListAllocator *g_list_allocator_new GListAllocator *allocator Describe this function FIXME! GListAllocator *allocator A list allocator pointer void g_list_allocator_free GListAllocator *allocator Describe this thing. FIXME! GListAllocator *allocator The pointer to list allocator to free. GListAllocator *g_slist_set_allocator GListAllocator *allocator This function will set the allocator for a singly linked list FIXME GListAllocator *allocator The pointer to the list allocator to use for the signly linked lists allocations. GListAllocator *g_list_set_allocator GListAllocator *allocator This function will set the allocator for a doubly linked list FIXME GListAllocator *allocator The pointer to the list allocator to use for the doubly linked list allocations. Signly linked lists! GSList *g_slist_alloc voidnone FIXME void (null) This function takes no arguments GSList *g_slist_free GSList *list FIXME GSList *list A pointer to a GSList structure. GSList *g_slist_free_1 GSList *list FIXME GSList *list A pointer to a GSList structure. GSList *g_slist_append GSList *list gpointer data Append the data to the list given in the list argument. This function will store the pointer to the data and return a new list pointer with the new element attached to the end. FIXME GSList *list The pointer to the list to append the dataitem to. This can be NULL in the case of a new list. gpointer data A pointer to the data to store in this list element GSList *g_slist_preppend GSList *list gpointer data FIXME GSList *list A pointer to a GSList structure. gpointer data A pointer to the data for this list element GSList *g_slist_insert GSList *list gpointer data gint position FIXME GSList *list A pointer to a GSList structure. GSList *g_slist_insert_sorted GSList *list gpointer data GCompareFunc func FIXME GSList *g_slist_concat GSList *list1 GSList *list2 FIXME GSList *g_slist_remove GSList *list gpointer data FIXME GSList *g_slist_remove_link GSList *list GSList *llink FIXME GSList *g_slist_reverse GSList *list FIXME GSList *g_slist_nth GSList *list guint n FIXME GSList *g_slist_find GSList *list gpointer data FIXME GSList *g_slist_find_custom GSList *list gpointer data GCompareFunc func FIXME gint g_slist_position GSList *list GSList *llink FIXME gint g_slist_index GSList *list gpointer data FIXME GSList *g_slist_last GSList *list FIXME guint g_slist_length GSList *list FIXME void g_slist_foreach GSList *list GFunc func gpointer user_data FIXME gpointer g_slist_nth_data GSList *list guint n FIXME GSList *g_slist_next GSList *list FIXME Doubly linked lists! GList *g_list_alloc voidnone FIXME GList *g_list_free GList *list This function will destroy and free the resources used by the GList structure. It will not free the resources consumed by the data pointers in the list that is up to the application to free. GList *list; /* add elements and otherwise manipulate the list */ /* once finished with the list free all elements of the list */ /* Then free the list structure itself */ g_list_free (list); GList *list A pointer to the GList structure to free GList *g_list_free_1 GList *list FIXME GList *g_list_append GList *list gpointer data FIXME GList *g_list_preppend GList *list gpointer data FIXME GList *g_list_insert GList *list gpointer data gint position FIXME GList *g_list_insert_sorted GList *list gpointer data GCompareFunc func FIXME GList *g_list_concat GList *list1 GList *list2 FIXME GList *g_list_remove GList *list gpointer data FIXME GList *g_list_remove_link GList *list GList *llink FIXME GList *g_list_reverse GList *list FIXME GList *g_list_nth GList *list guint n FIXME GList *g_list_find GList *list gpointer data FIXME GList *g_list_find_custom GList *list gpointer data GCompareFunc func FIXME gint g_list_position GList *list GList *llink FIXME gint g_list_index GList *list gpointer data FIXME GList *g_list_last GList *list FIXME guint g_list_length GList *list FIXME void g_list_foreach GList *list GFunc func gpointer user_data FIXME gpointer g_list_nth_data GList *list guint n FIXME GList *g_list_previous GList *list FIXME GList *g_list_next GList *list FIXME