![]() |
![]() |
![]() |
Tracker SPARQL Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#include <tracker-sparql.h> TrackerSparqlBuilder; enum TrackerSparqlBuilderState; TrackerSparqlBuilder* tracker_sparql_builder_new (void
); TrackerSparqlBuilder* tracker_sparql_builder_new_embedded_insert (void
); TrackerSparqlBuilder* tracker_sparql_builder_new_update (void
); TrackerSparqlBuilderState tracker_sparql_builder_get_state (TrackerSparqlBuilder *self
); const char* tracker_sparql_builder_get_result (TrackerSparqlBuilder *self
); gint tracker_sparql_builder_get_length (TrackerSparqlBuilder *self
); void tracker_sparql_builder_append (TrackerSparqlBuilder *self
,const char *raw
); void tracker_sparql_builder_prepend (TrackerSparqlBuilder *self
,const char *raw
); void tracker_sparql_builder_insert_open (TrackerSparqlBuilder *self
,const char *graph
); void tracker_sparql_builder_insert_silent_open (TrackerSparqlBuilder *self
,const char *graph
); void tracker_sparql_builder_insert_close (TrackerSparqlBuilder *self
); void tracker_sparql_builder_where_open (TrackerSparqlBuilder *self
); void tracker_sparql_builder_where_close (TrackerSparqlBuilder *self
); void tracker_sparql_builder_delete_open (TrackerSparqlBuilder *self
,const char *graph
); void tracker_sparql_builder_delete_close (TrackerSparqlBuilder *self
); void tracker_sparql_builder_drop_graph (TrackerSparqlBuilder *self
,const char *iri
); void tracker_sparql_builder_subject_variable (TrackerSparqlBuilder *self
,const char *var_name
); void tracker_sparql_builder_subject_iri (TrackerSparqlBuilder *self
,const char *iri
); void tracker_sparql_builder_subject (TrackerSparqlBuilder *self
,const char *s
); void tracker_sparql_builder_predicate_iri (TrackerSparqlBuilder *self
,const char *iri
); void tracker_sparql_builder_predicate (TrackerSparqlBuilder *self
,const char *s
); void tracker_sparql_builder_object_iri (TrackerSparqlBuilder *self
,const char *iri
); void tracker_sparql_builder_object (TrackerSparqlBuilder *self
,const char *s
); void tracker_sparql_builder_object_string (TrackerSparqlBuilder *self
,const char *literal
); void tracker_sparql_builder_object_boolean (TrackerSparqlBuilder *self
,gboolean literal
); void tracker_sparql_builder_object_int64 (TrackerSparqlBuilder *self
,gint64 literal
); void tracker_sparql_builder_object_date (TrackerSparqlBuilder *self
,time_t *literal
); void tracker_sparql_builder_object_double (TrackerSparqlBuilder *self
,double literal
); void tracker_sparql_builder_object_variable (TrackerSparqlBuilder *self
,const char *var_name
); void tracker_sparql_builder_object_blank_open (TrackerSparqlBuilder *self
); void tracker_sparql_builder_object_blank_close (TrackerSparqlBuilder *self
); void tracker_sparql_builder_object_unvalidated (TrackerSparqlBuilder *self
,const char *value
);
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.
typedef struct _TrackerSparqlBuilder TrackerSparqlBuilder;
The TrackerSparqlBuilder object represents an insertion/update SPARQL query.
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;
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 |
TrackerSparqlBuilder* tracker_sparql_builder_new (void
);
Creates a stateless TrackerSparqlBuilder.
Returns : |
a newly created TrackerSparqlBuilder. Free with g_object_unref() when done
|
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.
Returns : |
a newly created TrackerSparqlBuilder. Free with g_object_unref() when done
|
TrackerSparqlBuilder* tracker_sparql_builder_new_update (void
);
Creates an empty TrackerSparqlBuilder for an update query.
Returns : |
a newly created TrackerSparqlBuilder. Free with g_object_unref() when done
|
TrackerSparqlBuilderState tracker_sparql_builder_get_state
(TrackerSparqlBuilder *self
);
|
|
Returns : |
const char* tracker_sparql_builder_get_result (TrackerSparqlBuilder *self
);
|
|
Returns : |
gint tracker_sparql_builder_get_length (TrackerSparqlBuilder *self
);
Returns the number of objects added to self
.
|
a TrackerSparqlBuilder |
Returns : |
the number of objects contained. |
void tracker_sparql_builder_append (TrackerSparqlBuilder *self
,const char *raw
);
Appends raw, unvalidated content to self
.
|
a TrackerSparqlBuilder |
|
raw content to append. |
void tracker_sparql_builder_prepend (TrackerSparqlBuilder *self
,const char *raw
);
Prepends raw, unvalidated content to self
.
|
a TrackerSparqlBuilder |
|
raw content to prepend. |
void tracker_sparql_builder_insert_open (TrackerSparqlBuilder *self
,const char *graph
);
Opens an insertion statement.
|
a TrackerSparqlBuilder |
|
graph name, or NULL .
|
void tracker_sparql_builder_insert_silent_open (TrackerSparqlBuilder *self
,const char *graph
);
Opens a silent insertion statement.
|
a TrackerSparqlBuilder |
|
graph name, or NULL .
|
void tracker_sparql_builder_insert_close (TrackerSparqlBuilder *self
);
Closes an insertion statement opened with tracker_sparql_builder_insert_open()
.
|
a TrackerSparqlBuilder |
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.
|
a TrackerSparqlBuilder |
void tracker_sparql_builder_where_close (TrackerSparqlBuilder *self
);
Closes a WHERE clause opened through tracker_sparql_builder_where_open()
.
|
a TrackerSparqlBuilder |
void tracker_sparql_builder_delete_open (TrackerSparqlBuilder *self
,const char *graph
);
Opens a DELETE clause. Data triples may be appended in order to prepare a query to delete them.
|
a TrackerSparqlBuilder |
|
graph name, or NULL .
|
void tracker_sparql_builder_delete_close (TrackerSparqlBuilder *self
);
Closes a DELETE clause opened through tracker_sparql_builder_delete_open()
.
|
a TrackerSparqlBuilder |
void tracker_sparql_builder_drop_graph (TrackerSparqlBuilder *self
,const char *iri
);
Appends a DROP GRAPH clause.
|
a TrackerSparqlBuilder |
|
a graph name. |
void tracker_sparql_builder_subject_variable (TrackerSparqlBuilder *self
,const char *var_name
);
Appends a subject as a SPARQL variable, such as "?urn".
|
a TrackerSparqlBuilder |
|
variable name, without leading '?' |
void tracker_sparql_builder_subject_iri (TrackerSparqlBuilder *self
,const char *iri
);
Appends a subject as an IRI, such as "<urn:file:1234-5678>". IRIs univocally identify a resource in tracker-store.
|
a TrackerSparqlBuilder |
|
IRI name, without leading and trailing greater/less than symbols. |
void tracker_sparql_builder_subject (TrackerSparqlBuilder *self
,const char *s
);
Appends a subject.
|
a TrackerSparqlBuilder |
|
subject string |
void tracker_sparql_builder_predicate_iri (TrackerSparqlBuilder *self
,const char *iri
);
Appends a predicate as an IRI.
|
a TrackerSparqlBuilder |
|
IRI name, without leading and trailing greater/less than symbols. |
void tracker_sparql_builder_predicate (TrackerSparqlBuilder *self
,const char *s
);
Appends a predicate for the previously appended subject.
|
a TrackerSparqlBuilder |
|
predicate string |
void tracker_sparql_builder_object_iri (TrackerSparqlBuilder *self
,const char *iri
);
Appends an object as an IRI.
|
a TrackerSparqlBuilder |
|
IRI name, without leading and trailing greater/less than symbols. |
void tracker_sparql_builder_object (TrackerSparqlBuilder *self
,const char *s
);
Appends a free-form object for the previously appended subject and predicate.
|
a TrackerSparqlBuilder |
|
object string |
void tracker_sparql_builder_object_string (TrackerSparqlBuilder *self
,const char *literal
);
Appends an object formatted as an string. literal
will be escaped and surrounded
by double quotes.
|
a TrackerSparqlBuilder |
|
string object |
void tracker_sparql_builder_object_boolean (TrackerSparqlBuilder *self
,gboolean literal
);
Appends a gboolean value as an object.
|
a TrackerSparqlBuilder |
|
object as a gboolean |
void tracker_sparql_builder_object_int64 (TrackerSparqlBuilder *self
,gint64 literal
);
Appends a gint64 value as an object.
|
a TrackerSparqlBuilder |
|
object as a gint64 |
void tracker_sparql_builder_object_date (TrackerSparqlBuilder *self
,time_t *literal
);
Appends a time_t value as an object. literal
will be converted
to a string in the date format used by tracker-store.
|
a TrackerSparqlBuilder |
|
object as a time_t |
void tracker_sparql_builder_object_double (TrackerSparqlBuilder *self
,double literal
);
Appends a gdouble value as an object.
|
a TrackerSparqlBuilder |
|
object as a gdouble |
void tracker_sparql_builder_object_variable (TrackerSparqlBuilder *self
,const char *var_name
);
Appends an object as a SparQL variable, such as "?urn".
|
a TrackerSparqlBuilder |
|
variable name, without leading '?' |
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.
|
a TrackerSparqlBuilder |
void tracker_sparql_builder_object_blank_close
(TrackerSparqlBuilder *self
);
Closes an anomymous blank node opened with tracker_sparql_builder_object_blank_open()
|
a TrackerSparqlBuilder |
void tracker_sparql_builder_object_unvalidated (TrackerSparqlBuilder *self
,const char *value
);
Appends a string not validated as UTF-8 as an object.
|
a TrackerSparqlBuilder |
|
possibly UTF-8 invalid string. |
"length"
property"length" gint : Read
Number of objects added to the TrackerSparqlBuilder.
Default value: 0
"result"
property"result" gchar* : Read
String containing the constructed SPARQL in the TrackerSparqlBuilder.
Default value: NULL
"state"
property"state" TrackerSparqlBuilderState : Read
Current state of the TrackerSparqlBuilder.
Default value: TRACKER_SPARQL_BUILDER_STATE_UPDATE