函数

GLibHashTablenew

声明 [源]

GHashTable*
g_hash_table_new (
  GHashFunc hash_func,
  GEqualFunc key_equal_func
)

描述 [源]

创建一个新的具有引用计数为 1 的 GHashTable。

hash_func 返回的哈希值用于确定键在 GHashTable 数据结构中的存储位置。提供了一些常见键类型的函数，例如 g_direct_hash()、g_int_hash()、g_int64_hash()、g_double_hash() 和 g_str_hash()。如果 hash_func 为 NULL，则使用 g_direct_hash()。

key_equal_func 在搜索 GHashTable 中的键时使用。为最常见的键类型提供了 g_direct_equal()、g_int_equal()、g_int64_equal()、g_double_equal() 和 g_str_equal() 函数。如果 key_equal_func 为 NULL，则键将直接比较，类似于 g_direct_equal()，但无需函数调用的开销。key_equal_func 将带哈希表中的键作为第一个参数，以及要检查的用户提供的键作为第二个参数。

此函数不直接对语言绑定可用。

参数

hash_func

类型： GHashFunc

从一个键创建哈希值的函数。

key_equal_func

类型： GEqualFunc

用于检查两个键是否相等的函数。

返回值

类型： GHashTable

一个新的 GHashTable。

函数的调用者将拥有数据所有权，并负责释放它。