函数

GLibdatalist_id_set_data_full

声明 [源代码]

void
g_datalist_id_set_data_full (
  GData** datalist,
  GQuark key_id,
  gpointer data,
  GDestroyNotify destroy_func
)

说明 [源代码]

设置与给定 GQuark ID 对应的数据，以及当元素从数据列表中删除时要调用的函数。之前具有相同键的任何数据都将被删除，并且会调用其析构函数。

语言绑定无法直接使用此函数。

参数

datalist

类型： GData

数据列表。

数据由函数的调用者所有。
key_id

类型： GQuark

用于识别数据元素的 GQuark。

data

类型： gpointer

数据元素或 NULL，用于删除任何对应于 key_id 的先前元素。

此参数可以是 NULL。
数据由函数的调用者所有。
destroy_func

类型： GDestroyNotify

当数据元素被删除时要调用的函数。此函数将使用数据元素进行调用，并且可用于释放为此数据分配的任何内存。如果 data 为 NULL，则 destroy_func 也必须为 NULL。

此参数可以是 NULL。