函数

GLibTreenew_full

声明 [源代码]

GTree*
g_tree_new_full (
  GCompareDataFunc key_compare_func,
  gpointer key_compare_data,
  GDestroyNotify key_destroy_func,
  GDestroyNotify value_destroy_func
)

描述 [源代码]

创建一个新 GTree，类似于 g_tree_new()，并允许指定在从 GTree 移除条目时调用的释放键值所分配内存的函数。

参数

key_compare_func

类型: GCompareDataFunc

Qsort() 样式的比较函数。

key_compare_data

类型: gpointer

传递给比较函数的数据。

该参数可以是 NULL。

该数据由函数的调用者拥有。

key_destroy_func

类型: GDestroyNotify

一个用于在从 GTree 或 NULL 移除条目时释放用于键的内存分配的函数，如果不想提供该函数则为 NULL。

value_destroy_func

类型: GDestroyNotify

一个用于在从 GTree 或 NULL 移除条目时释放用于值的内存分配的函数，如果不想提供该函数则为 NULL。

返回值

类型: GTree

一个新分配的 GTree。

函数的调用者将拥有关数据，并负责释放它。