GSList

typedef struct {
  gpointer data;
  GSList *next;
} GSList;

The GSList struct is used for each element in the singly-linked list. The data field holds the element's data, which can be a pointer to any kind of data, or any integer value using the Type Conversion Macros. The next field contains the link to the next element in the list.

g_slist_alloc ()

GSList*     g_slist_alloc                   (void);

Allocates space for one GSList element. It is called by the g_slist_append(), g_slist_prepend(), g_slist_insert() and g_slist_insert_sorted() functions and so is rarely used on its own.

g_slist_append ()

GSList*     g_slist_append                  (GSList *list,
                                             gpointer data);

Adds a new element on to the end of the list.

  /* Notice that these are initialized to the empty list. */
  GSList *list = NULL, *number_list = NULL;

  /* This is a list of strings. */
  list = g_slist_append (list, "first");
  list = g_slist_append (list, "second");

  /* This is a list of integers. */
  number_list = g_slist_append (number_list, GINT_TO_POINTER (27));
  number_list = g_slist_append (number_list, GINT_TO_POINTER (14));

g_slist_prepend ()

GSList*     g_slist_prepend                 (GSList *list,
                                             gpointer data);

Adds a new element on to the start of the list.

  /* Notice that it is initialized to the empty list. */
  GSList *list = NULL;
  list = g_slist_prepend (list, "last");
  list = g_slist_prepend (list, "first");

g_slist_insert ()

GSList*     g_slist_insert                  (GSList *list,
                                             gpointer data,
                                             gint position);

Inserts a new element into the list at the given position.

g_slist_insert_before ()

GSList*     g_slist_insert_before           (GSList *slist,
                                             GSList *sibling,
                                             gpointer data);

Inserts a node before sibling containing data. Returns the new head of the list.

g_slist_insert_sorted ()

GSList*     g_slist_insert_sorted           (GSList *list,
                                             gpointer data,
                                             GCompareFunc func);

Inserts a new element into the list, using the given comparison function to determine its position.

g_slist_remove ()

GSList*     g_slist_remove                  (GSList *list,
                                             gconstpointer data);

Removes an element from a GSList. If two elements contain the same data, only the first is removed. If none of the elements contain the data, the GSList is unchanged.

g_slist_remove_link ()

GSList*     g_slist_remove_link             (GSList *list,
                                             GSList *link_);

Removes an element from a GSList, without freeing the element. The removed element's next link is set to NULL, so that it becomes a self-contained list with one element.

g_slist_delete_link ()

GSList*     g_slist_delete_link             (GSList *list,
                                             GSList *link_);

Deletes a node of list. Returns the new list head.

g_slist_remove_all ()

GSList*     g_slist_remove_all              (GSList *list,
                                             gconstpointer data);

Removes all list nodes with data equal to data. Returns the new head of the list. Contrast with g_slist_remove() which removes only the first node matching the given data.

g_slist_free ()

void        g_slist_free                    (GSList *list);

Frees all of the memory used by a GSList. The freed elements are added to the GAllocator free list.

g_slist_free_1 ()

void        g_slist_free_1                  (GSList *list);

Frees one GSList element. It is usually used after g_slist_remove_link().

g_slist_length ()

guint       g_slist_length                  (GSList *list);

Gets the number of elements in a GSList.

g_slist_copy ()

GSList*     g_slist_copy                    (GSList *list);

Copies a GSList.

Note that this is a "shallow" copy. If the list elements consist of pointers to data, the pointers are copied but the actual data isn't.

g_slist_reverse ()

GSList*     g_slist_reverse                 (GSList *list);

Reverses a GSList.

g_slist_sort ()

GSList*     g_slist_sort                    (GSList *list,
                                             GCompareFunc compare_func);

Sorts a GSList using the given comparison function.

g_slist_sort_with_data ()

GSList*     g_slist_sort_with_data          (GSList *list,
                                             GCompareDataFunc compare_func,
                                             gpointer user_data);

Like g_slist_sort(), but the sort function accepts a user data argument.

g_slist_concat ()

GSList*     g_slist_concat                  (GSList *list1,
                                             GSList *list2);

Adds the second GSList onto the end of the first GSList. Note that the elements of the second GSList are not copied. They are used directly.

g_slist_foreach ()

void        g_slist_foreach                 (GSList *list,
                                             GFunc func,
                                             gpointer user_data);

Calls a function for each element of a GSList.

g_slist_last ()

GSList*     g_slist_last                    (GSList *list);

Gets the last element in a GSList.

g_slist_next()

#define     g_slist_next(slist)

A convenience macro to gets the next element in a GSList.

g_slist_nth ()

GSList*     g_slist_nth                     (GSList *list,
                                             guint n);

Gets the element at the given position in a GSList.

g_slist_nth_data ()

gpointer    g_slist_nth_data                (GSList *list,
                                             guint n);

Gets the data of the element at the given position.

g_slist_find ()

GSList*     g_slist_find                    (GSList *list,
                                             gconstpointer data);

Finds the element in a GSList which contains the given data.

g_slist_find_custom ()

GSList*     g_slist_find_custom             (GSList *list,
                                             gconstpointer data,
                                             GCompareFunc func);

Finds an element in a GSList, using a supplied function to find the desired element. It iterates over the list, calling the given function which should return 0 when the desired element is found. The function takes two gconstpointer arguments, the GSList element's data and the given user data.

g_slist_position ()

gint        g_slist_position                (GSList *list,
                                             GSList *llink);

Gets the position of the given element in the GSList (starting from 0).

g_slist_index ()

gint        g_slist_index                   (GSList *list,
                                             gconstpointer data);

Gets the position of the element containing the given data (starting from 0).

g_slist_push_allocator ()

void        g_slist_push_allocator          (GAllocator *allocator);

Sets the allocator to use to allocate GSList elements. Use g_slist_pop_allocator() to restore the previous allocator.

Note that this function is not available if GLib has been compiled with --disable-mem-pools

g_slist_pop_allocator ()

void        g_slist_pop_allocator           (void);

Restores the previous GAllocator, used when allocating GSList elements.

Note that this function is not available if GLib has been compiled with --disable-mem-pools