结构
GLibRelation
废弃:2.26
说明 [src]
struct GRelation {
/* No available fields */
}
GRelation
是一个数据表,可以在任意数量的字段上建立索引,有点像简单的数据库表。GRelation
包含许多记录,称为元组。每个记录都包含许多字段。记录不是顺序的,因此无法找到特定索引处的记录。
请注意,GRelation
表目前仅限于 2 个字段。
要创建 GRelation
,请使用 g_relation_new()
。
若要指定要编制索引的字段,请使用 g_relation_index()
。请注意,在向 GRelation
中添加任何元组之前,必须调用此方法。
要向 GRelation
中添加记录,请使用 g_relation_insert()
。
若要确定某个给定的记录是否出现在 GRelation
中,请使用 g_relation_exists()
。请注意,字段会直接进行比较,因此指针必须指向完全相同的位置(即,同一个字符串的不同副本无法匹配)。
若要计算在给定字段中具有特定值的所有记录的数量,请使用 g_relation_count()
。
若要获取在给定字段中具有特定值的所有记录,请使用 g_relation_select()
。要访问结果记录的字段,请使用 g_tuples_index()
。要释放结果记录,请使用 g_tuples_destroy()
。
要删除在给定字段中具有特定值的所有记录,请使用 g_relation_delete()
。
若要销毁 GRelation
,请使用 g_relation_destroy()
。
若要帮助调试 GRelation
对象,请使用 g_relation_print()
。
GRelation
已被标记为已弃用,因为此 API 从未得到完全实现,也没有积极维护,并且很少被使用。
自 2.26 起已弃用。
很少使用的 API。
实例方法
g_relation_select
返回在给定字段中具有给定键的所有元组。使用 g_tuples_index() 访问返回的记录。返回的记录应该通过 g_tuples_destroy() 释放。
废弃:2.26