String 子包
String 子包提供一套 API,用于在键字符串与值之间建立关联。这种关联使用户能够高效地从数据存储中检索值。例如,客户端可能有一份姓名列表,每个姓名对应一个电话号码。哈希表可以用来构成一个简单的目录,其中姓名是键、电话号码是值,客户端只需提供姓名即可找到对应的电话号码。
使用 String 子包包括三个步骤:创建、插入和检索。通过调用 prg_string_hash_table_create() 或 prg_string_hash_table_create_options() 创建数据存储,该调用决定哈希表的单元数以及哈希函数使用的最大字符数。字符数越大越有助于减少冲突。
创建数据存储后,可使用 prg_string_hash_table_item_insert() 插入 (key,value) 对,并使用 prg_string_hash_table_item_remove() 删除。可通过调用 prg_string_hash_table_item_get() 检索某个 (key,value) 对。表中所有键或值的列表可分别用 prg_string_hash_table_keys_get() 和 prg_string_hash_table_values_get() 获取。可用 prg_string_hash_table_size_get() 确定哈希表的单元数,用 prg_string_hash_table_num_items_get() 确定哈希表中的条目数。
当不再需要某个哈希表时,使用 prg_string_hash_table_free() 将其销毁(但不销毁其中包含的值)。若要同时销毁哈希表及其值,使用 prg_string_hash_table_free_proc()。