函数

GLibHashTablereplace

声明 [源代码]

gboolean
g_hash_table_replace (
  GHashTable* hash_table,
  gpointer key,
  gpointer value
)

描述 [源代码]

向一个 GHashTable 插入一个新键和新值,类似于 g_hash_table_insert()。区别在于,如果键已经存在于 GHashTable 中,它将被新键替换。如果创建 GHashTable 时提供了 value_destroy_func,则使用该函数释放旧值。如果创建 GHashTable 时提供了 key_destroy_func,则使用该函数释放旧键。

从 GLib 2.40 开始,此函数返回布尔值以指示新添加的值是否已在哈希表中。

参数

hash_table

类型: GHashTable

一个 GHashTable

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

类型: gpointer

要插入的键。

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

类型: gpointer

与键相关联的值。

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

返回值

类型: gboolean

TRUE 如果键之前不存在。