Function

GLibSListcopy_deep

since: 2.34

Declaration [src]

GSList*
g_slist_copy_deep (
  GSList* list,
  GCopyFunc func,
  gpointer user_data
)

Description [src]

Makes a full (deep) copy of a GSList.

In contrast with g_slist_copy(), this function uses func to make a copy of each list element, in addition to copying the list container itself.

func, as a GCopyFunc, takes two arguments, the data to be copied and a user_data pointer. On common processor architectures, it’s safe to pass NULL as user_data if the copy function takes only one argument. You may get compiler warnings from this though if compiling with GCC’s -Wcast-function-type warning.

For instance, if list holds a list of GObjects, you can do:

another_list = g_slist_copy_deep (list, (GCopyFunc) g_object_ref, NULL);

And, to entirely free the new list, you could do:

g_slist_free_full (another_list, g_object_unref);

Available since: 2.34

This function is not directly available to language bindings.

Parameters

list

Type: A list of gpointer

A GSList.

The data is owned by the caller of the function.
func

Type: GCopyFunc

A copy function used to copy every element in the list.

user_data

Type: gpointer

User data passed to the copy function func, or NULL.

The argument can be NULL.
The data is owned by the caller of the function.

Return value

Type: A list of gpointer

A full copy of list, use g_slist_free_full() to free it.

The data is owned by the called function.