方法

GLibTreereplace_node

自:2.68

声明 [src]

GTreeNode*
g_tree_replace_node (
  GTree* tree,
  gpointer key,
  gpointer value
)

描述 [src]

GTree中插入新的键和值,类似于g_tree_insert_node()。不同的是,如果键已经存在于GTree中,则使用新键替换旧的键。如果创建GTree时提供了value_destroy_func,则使用该函数释放旧值。如果创建GTree时提供了key_destroy_func,则使用该函数释放旧键。

当添加新的键值对时,树会自动“平衡”,使得根到每个叶子的距离尽可能小。

自:2.68

参数

key

类型: gpointer

要插入的键。

参数可以是NULL
数据由方法调用者拥有。
value

类型: gpointer

对应于键的值。

参数可以是NULL
数据由方法调用者拥有。

返回值

类型: GTreeNode

插入的(或设置的)节点或NULL,如果插入会超出树节点计数器的话。

返回的数据由实例拥有。
返回值可以是NULL