函数

GLibHashTableadd

since: 2.32

声明 [src]

gboolean
g_hash_table_add (
  GHashTable* hash_table,
  gpointer key
)

描述 [src]

这是一个将 GHashTable 作为集合使用的便捷函数。它等价于调用 g_hash_table_replace(),其中 key 既有键又有值。

特别是,这意味着如果在散列表中已存在 key,则散列表中旧的 key 复制被释放,并在表中用 key 取代它。

当散列表只包含自身作为对应值的键时,可以更有效地存储。请参见描述部分中的讨论。

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

Available since: 2.32

参数

hash_table

类型: GHashTable

一个 GHashTable

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

类型: gpointer

要插入的键。

参数可以是 NULL
被调用的函数会获取数据的所有权,并且负责释放它。

返回值

类型: gboolean

TRUE 如果键尚不存在。