ListG.copyDeep

Makes a full (deep) copy of a #GList.

In contrast with g_list_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: |[<!-- language="C" --> another_list = g_list_copy_deep (list, (GCopyFunc) g_object_ref, NULL); ]|

And, to entirely free the new list, you could do: |[<!-- language="C" --> g_list_free_full (another_list, g_object_unref); ]|

class ListG
copyDeep
(
GCopyFunc func
,
void* userData
)

Parameters

func GCopyFunc

a copy function used to copy every element in the list

userData void*

user data passed to the copy function @func, or %NULL

Return Value

Type: ListG

the start of the new list that holds a full copy of @list, use g_list_free_full() to free it

Meta

Since

2.34