Top | ![]() |
![]() |
![]() |
![]() |
TrackerSparqlBuilder is an object what will gather a set of subject/predicate/object triples, together with an optional WHERE clause, in order to create a query that may be issued to tracker-store.
When using TrackerSparqlBuilder, note that you may append several predicates for the same subject, and several objects for the same predicate.
TrackerSparqlBuilder *
tracker_sparql_builder_new (void
);
Creates a stateless TrackerSparqlBuilder.
Since: 0.10
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.10
TrackerSparqlBuilder *
tracker_sparql_builder_new_update (void
);
Creates an empty TrackerSparqlBuilder for an update query.
Since: 0.10
TrackerSparqlBuilderState
tracker_sparql_builder_get_state (TrackerSparqlBuilder *self
);
Returns the current state of self
Since: 0.10
const gchar *
tracker_sparql_builder_get_result (TrackerSparqlBuilder *self
);
Retrieves a string representation of the constructed SPARQL query.
the created SPARQL query. The string is contained in the TrackerSparqlBuilder object, and should not be freed by the caller.
Since: 0.10
gint
tracker_sparql_builder_get_length (TrackerSparqlBuilder *self
);
Returns the number of objects added to self
.
Since: 0.10
void tracker_sparql_builder_append (TrackerSparqlBuilder *self
,const gchar *raw
);
tracker_sparql_builder_append
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends raw, unvalidated content to self
.
Since: 0.10
void tracker_sparql_builder_prepend (TrackerSparqlBuilder *self
,const gchar *raw
);
tracker_sparql_builder_prepend
has been deprecated since version 2.0 and should not be used in newly-written code.
Prepends raw, unvalidated content to self
.
Since: 0.10
void tracker_sparql_builder_insert_open (TrackerSparqlBuilder *self
,const gchar *graph
);
tracker_sparql_builder_insert_open
has been deprecated since version 2.0 and should not be used in newly-written code.
Opens an insertion statement.
Since: 0.10
void tracker_sparql_builder_insert_silent_open (TrackerSparqlBuilder *self
,const gchar *graph
);
tracker_sparql_builder_insert_silent_open
has been deprecated since version 2.0 and should not be used in newly-written code.
Opens a silent insertion statement.
Since: 0.10
void
tracker_sparql_builder_insert_close (TrackerSparqlBuilder *self
);
tracker_sparql_builder_insert_close
has been deprecated since version 2.0 and should not be used in newly-written code.
Closes an insertion statement opened with tracker_sparql_builder_insert_open()
.
Since: 0.10
void
tracker_sparql_builder_where_open (TrackerSparqlBuilder *self
);
tracker_sparql_builder_where_open
has been deprecated since version 2.0 and should not be used in newly-written code.
Opens a WHERE clause. Data triples may be appended then to narrow the scope to which the update query applies.
Since: 0.10
void
tracker_sparql_builder_where_close (TrackerSparqlBuilder *self
);
tracker_sparql_builder_where_close
has been deprecated since version 2.0 and should not be used in newly-written code.
Closes a WHERE clause opened through tracker_sparql_builder_where_open()
.
Since: 0.10
void tracker_sparql_builder_delete_open (TrackerSparqlBuilder *self
,const gchar *graph
);
tracker_sparql_builder_delete_open
has been deprecated since version 2.0 and should not be used in newly-written code.
Opens a DELETE clause. Data triples may be appended in order to prepare a query to delete them.
Since: 0.10
void
tracker_sparql_builder_delete_close (TrackerSparqlBuilder *self
);
tracker_sparql_builder_delete_close
has been deprecated since version 2.0 and should not be used in newly-written code.
Closes a DELETE clause opened through tracker_sparql_builder_delete_open()
.
Since: 0.10
void tracker_sparql_builder_graph_open (TrackerSparqlBuilder *self
,const gchar *graph
);
tracker_sparql_builder_graph_open
has been deprecated since version 2.0 and should not be used in newly-written code.
Opens a GRAPH clause within INSERT, DELETE, or WHERE.
Since: 0.10
void
tracker_sparql_builder_graph_close (TrackerSparqlBuilder *self
);
tracker_sparql_builder_graph_close
has been deprecated since version 2.0 and should not be used in newly-written code.
Closes a GRAPH clause opened through tracker_sparql_builder_graph_open()
.
Since: 0.10
void tracker_sparql_builder_subject_variable (TrackerSparqlBuilder *self
,const gchar *var_name
);
tracker_sparql_builder_subject_variable
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a subject as a SPARQL variable, such as "?urn".
Since: 0.10
void tracker_sparql_builder_subject_iri (TrackerSparqlBuilder *self
,const gchar *iri
);
tracker_sparql_builder_subject_iri
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a subject as an IRI, such as "<urn:file:1234-5678>". IRIs univocally identify a resource in tracker-store.
Since: 0.10
void tracker_sparql_builder_subject (TrackerSparqlBuilder *self
,const gchar *s
);
tracker_sparql_builder_subject
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a subject.
Since: 0.10
void tracker_sparql_builder_predicate_iri (TrackerSparqlBuilder *self
,const gchar *iri
);
tracker_sparql_builder_predicate_iri
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a predicate as an IRI.
Since: 0.10
void tracker_sparql_builder_predicate (TrackerSparqlBuilder *self
,const gchar *s
);
tracker_sparql_builder_predicate
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a predicate for the previously appended subject.
Since: 0.10
void tracker_sparql_builder_object_iri (TrackerSparqlBuilder *self
,const gchar *iri
);
tracker_sparql_builder_object_iri
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends an object as an IRI.
Since: 0.10
void tracker_sparql_builder_object (TrackerSparqlBuilder *self
,const gchar *s
);
tracker_sparql_builder_object
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a free-form object for the previously appended subject and predicate.
Since: 0.10
void tracker_sparql_builder_object_string (TrackerSparqlBuilder *self
,const gchar *literal
);
tracker_sparql_builder_object_string
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends an object formatted as an string. literal
will be escaped and surrounded
by double quotes.
Since: 0.10
void tracker_sparql_builder_object_boolean (TrackerSparqlBuilder *self
,gboolean literal
);
tracker_sparql_builder_object_boolean
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a gboolean value as an object.
Since: 0.10
void tracker_sparql_builder_object_int64 (TrackerSparqlBuilder *self
,gint64 literal
);
tracker_sparql_builder_object_int64
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a gint64 value as an object.
Since: 0.10
void tracker_sparql_builder_object_date (TrackerSparqlBuilder *self
,time_t *literal
);
tracker_sparql_builder_object_date
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a time_t value as an object. literal
will be converted
to a string in the date format used by tracker-store.
Since: 0.10
void tracker_sparql_builder_object_double (TrackerSparqlBuilder *self
,gdouble literal
);
tracker_sparql_builder_object_double
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a gdouble value as an object.
Since: 0.10
void tracker_sparql_builder_object_variable (TrackerSparqlBuilder *self
,const gchar *var_name
);
tracker_sparql_builder_object_variable
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends an object as a SparQL variable, such as "?urn".
Since: 0.10
void
tracker_sparql_builder_object_blank_open
(TrackerSparqlBuilder *self
);
tracker_sparql_builder_object_blank_open
has been deprecated since version 2.0 and should not be used in newly-written code.
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.10
void
tracker_sparql_builder_object_blank_close
(TrackerSparqlBuilder *self
);
tracker_sparql_builder_object_blank_close
has been deprecated since version 2.0 and should not be used in newly-written code.
Closes an anomymous blank node opened with tracker_sparql_builder_object_blank_open()
Since: 0.10
void tracker_sparql_builder_object_unvalidated (TrackerSparqlBuilder *self
,const gchar *value
);
tracker_sparql_builder_object_unvalidated
has been deprecated since version 2.0 and should not be used in newly-written code.
Appends a string not validated as UTF-8 as an object.
Since: 0.10
struct TrackerSparqlBuilder;
The TrackerSparqlBuilder object represents an insertion/update SPARQL query.
Enumeration with the possible states of the SPARQL Builder
Builder is generating an UPDATE |
||
Builder is generating an INSERT |
||
Builder is generating a DELETE |
||
Builder is generating the subject of the query |
||
Builder is generating the predicate of the query |
||
Builder is generating the object of the query |
||
Builder is generating a blank node subject |
||
Builder is generating the WHERE clause contents |
||
Builder is generating an embedded INSERT |
||
Builder is generating the GRAPH clause contents |
“length”
property “length” gint
Number of objects added to the TrackerSparqlBuilder.
Flags: Read
Default value: 0
Since: 0.10
“result”
property “result” gchar *
String containing the constructed SPARQL in the TrackerSparqlBuilder.
Flags: Read
Default value: NULL
Since: 0.10
“state”
property“state” TrackerSparqlBuilderState
Current state of the TrackerSparqlBuilder.
Flags: Read
Default value: TRACKER_SPARQL_BUILDER_STATE_UPDATE
Since: 0.10