Bin 子包

Bin 子包提供一套 API,用于在二进制键与值之间建立关联。使用 Bin 子包包括三个步骤:创建、插入和检索。通过调用 prg_bin_hash_table_create() 创建数据存储,该调用决定哈希表的单元数以及哈希函数使用的最大字节数。字节数越大越有助于减少冲突,代价是哈希函数计算时间增加;单元数越大则冲突概率越低,代价是哈希表稀疏时内存占用增加。

创建数据存储后,可使用 prg_bin_hash_table_item_insert() 插入 (key,value) 对,并使用 prg_bin_hash_table_item_remove() 删除。与某个键关联的值可通过调用 prg_bin_hash_table_item_get() 检索。哈希表中所有 (key,value) 对的列表可用 prg_bin_hash_table_item_list_get() 获取。可用 prg_bin_hash_table_num_items_get() 确定哈希表中的条目数。

当不再需要某个哈希表时,使用 prg_bin_hash_table_destroy() 将其销毁。

Bin 子包还包含两个用于计算一块二进制数据哈希值的函数:prg_bin_hash_bytes_array() 和 prg_bin_hash_int_array()。