Function
GLibPtrArrayextend
since: 2.62
Declaration [src]
void
g_ptr_array_extend (
GPtrArray* array_to_extend,
GPtrArray* array,
GCopyFunc func,
gpointer user_data
)
Description [src]
Adds all pointers of array to the end of the array array_to_extend.
The array will grow in size automatically if needed. array_to_extend is
modified in-place.
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.
If func is NULL, then only the pointers (and not what they are
pointing to) are copied to the new GPtrArray.
Whether array_to_extend is NULL terminated stays unchanged by this function.
Available since: 2.62
This function is not directly available to language bindings.
Parameters
array_to_extend-
Type: An array of
gpointerA
GPtrArray.The data is owned by the caller of the function. array-
Type: An array of
gpointerA
GPtrArrayto add to the end ofarray_to_extend.The data is owned by the caller of the function. func-
Type:
GCopyFuncA copy function used to copy every element in the array.
user_data-
Type:
gpointerUser data passed to the copy function
func, orNULL.The argument can be NULL.The data is owned by the caller of the function.