Basics
Guides
API Reference
Basics
Guides
API Reference
[34:7] extends: object
A GRelation is a table of data which can be indexed on any number of
fields, rather like simple database tables. A GRelation contains a number
of records, called tuples. Each record contains a number of fields. Records
are not ordered, so it is not possible to find the record at a particular
index. Note that GRelation tables are currently limited to 2 fields. To
create a GRelation, use [func@GLib.Relation.new]. To specify which fields
should be indexed, use [method@GLib.Relation.index]. Note that this must be
called before any tuples are added to the GRelation. To add records to a
GRelation use [method@GLib.Relation.insert]. To determine if a given record
appears in a GRelation, use [method@GLib.Relation.exists]. Note that fields
are compared directly, so pointers must point to the exact same position
(i.e. different copies of the same string will not match.) To count the
number of records which have a particular value in a given field, use
[method@GLib.Relation.count]. To get all the records which have a particular
value in a given field, use [method@GLib.Relation.select]. To access fields
of the resulting records, use [method@GLib.Tuples.index]. To free the
resulting records use [method@GLib.Tuples.destroy]. To delete all records
which have a particular value in a given field, use
[method@GLib.Relation.delete]. To destroy the GRelation, use
[method@GLib.Relation.destroy]. To help debug GRelation objects, use
[method@GLib.Relation.print]. GRelation has been marked as deprecated,
since this API has never been fully implemented, is not very actively
maintained and rarely used.
GRelation (Handle = null)
Creates a new
Relationby wrapping a native handle or another wrapper.
Handle is the native handle or another wrapper whose handle to adopt.toNativeHandle (Source)
Normalizes a constructor argument into a raw pointer carrier. Accepts a raw NativeHandle, a raw NativeBuffer returned from
fn.call(...), another generated wrapper exposinghandle(), or null. Returns null when the argument carries no pointer.
Source is the raw handle, raw buffer, wrapper, or null.A raw pointer carrier or null when no pointer is present.getLib ()
Returns the opened native library for this generated wrapper.
The opened native library.handle ()
Returns the wrapped NativeHandle.
The wrapped NativeHandle.isNull ()
Returns true when the wrapped handle is null.
A bool.describe ()
Returns a small string for debugging generated wrappers.
A string.count (key, int field)
Returns the number of tuples in a #GRelation that have the given value in the given field.
key is the value to compare with..field is the field of each record to match..the number of matches..delete (key, int field)
Deletes any records from a #GRelation that have the given key value in the given field.
key is the value to compare with..field is the field of each record to match..the number of records deleted..destroy ()
Destroys the #GRelation, freeing all memory allocated. However, it does not free memory allocated for the tuple data, so you should free that first if appropriate.
None.exists (list varargs)
Returns %TRUE if a record with the given values exists in a #GRelation. Note that the values are compared directly, so that, for example, two copies of the same string will not match.
... is the fields of the record to compare. The number must match the number of fields in the #GRelation..%TRUE if a record matches..index (int field, object hash_func, object key_equal_func)
Creates an index on the given field. Note that this must be called before any records are added to the #GRelation.
field is the field to index, counting from 0..hash_func is a function to produce a hash value from the field data..key_equal_func is a function to compare two values of the given field..None.insert (list varargs)
Inserts a record into a #GRelation.
... is the fields of the record to add. These must match the number of fields in the #GRelation, and of type #gpointer or #gconstpointer..None.print ()
Outputs information about all records in a #GRelation, as well as the indexes. It is for debugging.
None.select (key, int field)
Returns all of the tuples which have the given key in the given field. Use g_tuples_index() to access the returned records. The returned records should be freed with g_tuples_destroy().
key is the value to compare with..field is the field of each record to match..the records (tuples) that matched..
Aussom
Write once. Embed everywhere.
Copyright 2026 Austin Lehman. All rights reserved.