函数

GLibHashTableinsert

声明 [src]

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

描述 [src]

将新的键和值插入到 GHashTable 中。

如果键已存在于 GHashTable 中,则其当前值将被新值替换。如果在创建 GHashTable 时提供了 value_destroy_func,则使用该函数释放旧值。如果创建 GHashTable 时提供了 key_destroy_func,则使用该函数释放传入的键。

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

参数

hash_table

类型: GHashTable

GHashTable。

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

类型: gpointer

要插入的键。

参数可以为 NULL
数据由函数的调用者拥有。
value

类型: gpointer

与键关联的值。

参数可以为 NULL
数据由函数的调用者拥有。

返回值

类型: gboolean

TRUE 如果键尚未存在。