struct TrackerSparqlBuilder

struct TrackerSparqlBuilder {
	GObject parent_instance;
	TrackerSparqlBuilderPrivate * priv;
};

The TrackerSparqlBuilder object represents an insertion/update SparQL query.

struct TrackerSparqlBuilderClass

struct TrackerSparqlBuilderClass {
	GObjectClass parent_class;
};

TrackerSparqlBuilderPrivate

typedef struct _TrackerSparqlBuilderPrivate TrackerSparqlBuilderPrivate;

enum TrackerSparqlBuilderState

typedef enum {
	TRACKER_SPARQL_BUILDER_STATE_UPDATE,
	TRACKER_SPARQL_BUILDER_STATE_INSERT,
	TRACKER_SPARQL_BUILDER_STATE_DELETE,
	TRACKER_SPARQL_BUILDER_STATE_SUBJECT,
	TRACKER_SPARQL_BUILDER_STATE_PREDICATE,
	TRACKER_SPARQL_BUILDER_STATE_OBJECT,
	TRACKER_SPARQL_BUILDER_STATE_BLANK,
	TRACKER_SPARQL_BUILDER_STATE_WHERE,
	TRACKER_SPARQL_BUILDER_STATE_EMBEDDED_INSERT
} TrackerSparqlBuilderState;

tracker_sparql_builder_new ()

TrackerSparqlBuilder * tracker_sparql_builder_new       (void);

Creates a stateless TrackerSparqlBuilder.

Since 0.8

tracker_sparql_builder_new_embedded_insert ()

TrackerSparqlBuilder * tracker_sparql_builder_new_embedded_insert
                                                        (void);

Creates a TrackerSparqlBuilder ready to be embedded in another query. In embedded inserts, the subject is implied (responsibility of the embedder), so only calls to append predicates and objects for the given subject are allowed.

Since 0.8

tracker_sparql_builder_new_update ()

TrackerSparqlBuilder * tracker_sparql_builder_new_update
                                                        (void);

Creates an empty TrackerSparqlBuilder for an update query.

Since 0.8

tracker_sparql_builder_construct ()

TrackerSparqlBuilder * tracker_sparql_builder_construct (GType object_type);

Since 0.8

tracker_sparql_builder_construct_embedded_insert ()

TrackerSparqlBuilder * tracker_sparql_builder_construct_embedded_insert
                                                        (GType object_type);

Since 0.8

tracker_sparql_builder_construct_update ()

TrackerSparqlBuilder * tracker_sparql_builder_construct_update
                                                        (GType object_type);

Since 0.8

tracker_sparql_builder_get_state ()

TrackerSparqlBuilderState tracker_sparql_builder_get_state
                                                        (TrackerSparqlBuilder *self);

Since 0.8

tracker_sparql_builder_get_result ()

const gchar *       tracker_sparql_builder_get_result   (TrackerSparqlBuilder *self);

Returns the constructed SparQL query as a string.

Since 0.8

tracker_sparql_builder_get_length ()

gint                tracker_sparql_builder_get_length   (TrackerSparqlBuilder *self);

Returns the number of objects added to self.

Since 0.8

tracker_sparql_builder_append ()

void                tracker_sparql_builder_append       (TrackerSparqlBuilder *self,
                                                         const gchar *raw);

Appends raw, unvalidated content to self.

Since 0.8

tracker_sparql_builder_prepend ()

void                tracker_sparql_builder_prepend      (TrackerSparqlBuilder *self,
                                                         const gchar *raw);

Prepends raw, unvalidated content to self.

Since 0.8

tracker_sparql_builder_insert_open ()

void                tracker_sparql_builder_insert_open  (TrackerSparqlBuilder *self,
                                                         const gchar *graph);

Opens an insertion statement.

Since 0.8

tracker_sparql_builder_insert_close ()

void                tracker_sparql_builder_insert_close (TrackerSparqlBuilder *self);

Closes an insertion statement opened with tracker_sparql_builder_insert_open().

Since 0.8

tracker_sparql_builder_where_open ()

void                tracker_sparql_builder_where_open   (TrackerSparqlBuilder *self);

Opens a WHERE clause. Data triples may be appended then to narrow the scope to which the update query applies.

Since 0.8

tracker_sparql_builder_where_close ()

void                tracker_sparql_builder_where_close  (TrackerSparqlBuilder *self);

Closes a WHERE clause opened through tracker_sparql_builder_where_open().

Since 0.8

tracker_sparql_builder_delete_open ()

void                tracker_sparql_builder_delete_open  (TrackerSparqlBuilder *self,
                                                         const gchar *graph);

Opens a DELETE clause. Data triples may be appended in order to prepare a query to delete them.

Since 0.8

tracker_sparql_builder_delete_close ()

void                tracker_sparql_builder_delete_close (TrackerSparqlBuilder *self);

Closes a DELETE clause opened through tracker_sparql_builder_delete_close().

Since 0.8

tracker_sparql_builder_drop_graph ()

void                tracker_sparql_builder_drop_graph   (TrackerSparqlBuilder *self,
                                                         const gchar *iri);

Appends a DROP GRAPH clause.

Since 0.8

tracker_sparql_builder_subject_variable ()

void                tracker_sparql_builder_subject_variable
                                                        (TrackerSparqlBuilder *self,
                                                         const gchar *var_name);

Appends a subject as a SparQL variable, such as "?urn".

Since 0.8

tracker_sparql_builder_subject_iri ()

void                tracker_sparql_builder_subject_iri  (TrackerSparqlBuilder *self,
                                                         const gchar *iri);

Appends a subject as an IRI, such as "<urn:file:1234-5678>". IRIs univocally identify a resource in tracker-store.

Since 0.8

tracker_sparql_builder_subject ()

void                tracker_sparql_builder_subject      (TrackerSparqlBuilder *self,
                                                         const gchar *s);

Appends a subject.

Since 0.8

tracker_sparql_builder_predicate_iri ()

void                tracker_sparql_builder_predicate_iri
                                                        (TrackerSparqlBuilder *self,
                                                         const gchar *iri);

Appends a predicate as an IRI.

Since 0.8

tracker_sparql_builder_predicate ()

void                tracker_sparql_builder_predicate    (TrackerSparqlBuilder *self,
                                                         const gchar *s);

Appends a predicate for the previously appended subject.

Since 0.8

tracker_sparql_builder_object_iri ()

void                tracker_sparql_builder_object_iri   (TrackerSparqlBuilder *self,
                                                         const gchar *iri);

Appends an object as an IRI.

Since 0.8

tracker_sparql_builder_object ()

void                tracker_sparql_builder_object       (TrackerSparqlBuilder *self,
                                                         const gchar *s);

Appends a free-form object for the previously appended subject and predicate.

Since 0.8

tracker_sparql_builder_object_string ()

void                tracker_sparql_builder_object_string
                                                        (TrackerSparqlBuilder *self,
                                                         const gchar *literal);

Appends an object formatted as an string. literal will be escaped and surrounded by double quotes.

Since 0.8

tracker_sparql_builder_object_boolean ()

void                tracker_sparql_builder_object_boolean
                                                        (TrackerSparqlBuilder *self,
                                                         gboolean literal);

Appends a gboolean value as an object.

Since 0.8

tracker_sparql_builder_object_int64 ()

void                tracker_sparql_builder_object_int64 (TrackerSparqlBuilder *self,
                                                         gint64 literal);

Appends a gint64 as an object.

Since 0.8

tracker_sparql_builder_object_date ()

void                tracker_sparql_builder_object_date  (TrackerSparqlBuilder *self,
                                                         time_t *literal);

Appends a time_t as an object. literal will be converted to a string in the date format used by tracker-store.

Since 0.8

tracker_sparql_builder_object_double ()

void                tracker_sparql_builder_object_double
                                                        (TrackerSparqlBuilder *self,
                                                         gdouble literal);

Appends a gdouble as an object.

Since 0.8

tracker_sparql_builder_object_variable ()

void                tracker_sparql_builder_object_variable
                                                        (TrackerSparqlBuilder *self,
                                                         const gchar *var_name);

Appends an object as a SparQL variable, such as "?urn".

Since 0.8

tracker_sparql_builder_object_blank_open ()

void                tracker_sparql_builder_object_blank_open
                                                        (TrackerSparqlBuilder *self);

Opens an anonymous blank node. In insertions this can be used to create anonymous nodes for not previously known data without the need of a separate insertion.

Since 0.8

tracker_sparql_builder_object_blank_close ()

void                tracker_sparql_builder_object_blank_close
                                                        (TrackerSparqlBuilder *self);

Closes an anomymous blank node opened with tracker_sparql_builder_object_blank_open()

Since 0.8

tracker_sparql_builder_object_unvalidated ()

void                tracker_sparql_builder_object_unvalidated
                                                        (TrackerSparqlBuilder *self,
                                                         const gchar *value);

Appends a string not validated as UTF-8 as an object.

Since 0.8