结构

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_new

使用指定数量的字段创建一个新的 GRelation。请注意,目前字段数量必须是 2。

废弃:2.26 

实例方法

g_relation_count

返回 GRelation 中具有给定字段的给定值的所有元组的数量。

废弃:2.26 

g_relation_delete

GRelation 中删除在给定字段中具有给定键值的任何记录。

废弃:2.26 

g_relation_destroy

销毁 GRelation,释放所有分配的内存。但是,它不会释放元组数据的分配内存,因此,如果合适的话,您应该先释放该内存。

废弃:2.26 

g_relation_exists

如果在 GRelation 中存在具有给定值的记录,则返回 TRUE。请注意,值会直接进行比较,因此,例如,同一个字符串的两个副本将无法匹配。

废弃:2.26 

g_relation_index

在给定字段上创建索引。请注意,在向 GRelation 添加任何记录之前必须调用此项。

废弃:2.26 

g_relation_insert

向 GRelation 插入记录。

废弃:2.26 

g_relation_print

输出 GRelation 中所有记录以及索引的信息。该方法用于调试。

废弃:2.26 

g_relation_select

返回在给定字段中具有给定键的所有元组。使用 g_tuples_index() 访问返回的记录。返回的记录应该通过 g_tuples_destroy() 释放。

废弃:2.26