函数

GLibHashTableforeach

声明 [源代码]

void
g_hash_table_foreach (
  GHashTable* hash_table,
  GHFunc func,
  gpointer user_data
)

描述 [源代码]

对 GHashTable 中的每个键/值对调用给定的函数。此函数传递每个对的键和值以及给定的 user_data 参数。在遍历时，散列表可能不会被修改（不能添加/删除项）。要删除所有匹配谓词的项，请使用 g_hash_table_foreach_remove()。

g_hash_table_foreach() 遍历散列表中的键/值的顺序是未定义的。

有关线性顺序搜索的性能注意事项，请参阅 g_hash_table_find() 与 g_hash_table_lookup() 对比。

参数

hash_table

类型: GHashTable

一个 GHashTable。

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

类型: GHFunc

用于调用每个键/值对的函数。

user_data

类型: gpointer

传递给函数的用户数据。

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