函数
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
。被调用的函数会获取数据的所有权,并且负责释放它。