RhythmDBQueryResults

RhythmDBQueryResults — interface for receiving query results from RhythmDB

Types and Values

Object Hierarchy

    GInterface
    ╰── RhythmDBQueryResults

Known Implementations

RhythmDBQueryResults is implemented by RhythmDBQueryModel.

Description

This is the interface that RhythmDB uses to report results of database queries. When running a query, it first calls rhythmdb_query_results_set_query, then passes entries matching the query to rhythmdb_query_results_add_results in batches, and finally calls rhythmdb_query_results_query_complete. There are no guarantees as to which threads the calls are made from.

Functions

rhythmdb_query_results_set_query ()

void
rhythmdb_query_results_set_query (RhythmDBQueryResults *results,
                                  GPtrArray *query);

When a new query is run, this method is invoked to give the object implementing this interface a chance to take a copy of the query criteria, so that it can evaluate the query for newly added or changed entries once the query is complete.

[skip]

Parameters

results

the RhythmDBQueryResults implementation

 

query

the new query

 

rhythmdb_query_results_add_results ()

void
rhythmdb_query_results_add_results (RhythmDBQueryResults *results,
                                    GPtrArray *entries);

Provides a new set of query results. References must be taken on the entries.

Parameters

results

the RhythmDBQueryResults implementation

 

entries

GPtrArray containing RhythmDBEntry results.

[element-type RB.RhythmDBEntry]

rhythmdb_query_results_query_complete ()

void
rhythmdb_query_results_query_complete (RhythmDBQueryResults *results);

Called when the query is complete and all entries that match the query have been supplied to rhythmdb_query_results_add_results. If the object implementing this interface needs to identify newly added or changed entries that match the query, it needs to use the entry-added, entry-deleted and entry-changed signals from RhythmDB.

Parameters

results

the RhythmDBQueryResults

 

Types and Values

RhythmDBQueryResults

typedef struct _RhythmDBQueryResults RhythmDBQueryResults;

struct RhythmDBQueryResultsIface

struct RhythmDBQueryResultsIface {
	GTypeInterface g_iface;

	/* vtable */
	void (*set_query)		(RhythmDBQueryResults *results,
				 	 GPtrArray *query);

	void (*add_results)		(RhythmDBQueryResults *results,
				 	 GPtrArray *entries);

	void 	(*query_complete) (RhythmDBQueryResults *results);
};