diff options
author | Aleksander Morgado <aleksander@lanedo.com> | 2011-02-08 12:48:04 +0100 |
---|---|---|
committer | Aleksander Morgado <aleksander@lanedo.com> | 2011-02-08 12:59:44 +0100 |
commit | bcc26c6b51cadb163cac34747248205b980fe479 (patch) | |
tree | d946825a6a17b854b54115217e18af7d94532297 | |
parent | 19197529635594df19eb46592cf434fb3a665e35 (diff) | |
download | tracker-bcc26c6b51cadb163cac34747248205b980fe479.tar.gz |
libtracker-sparql: Builder API is all new in 0.10, as this is a new library
-rw-r--r-- | src/libtracker-sparql/tracker-builder.vala | 67 |
1 files changed, 39 insertions, 28 deletions
diff --git a/src/libtracker-sparql/tracker-builder.vala b/src/libtracker-sparql/tracker-builder.vala index 07d1ad488..a7c3b6895 100644 --- a/src/libtracker-sparql/tracker-builder.vala +++ b/src/libtracker-sparql/tracker-builder.vala @@ -52,6 +52,7 @@ * * Returns: a newly created #TrackerSparqlBuilder. Free with g_object_unref() when done * + * Since: 0.10 */ public class Tracker.Sparql.Builder : Object { @@ -92,13 +93,15 @@ public class Tracker.Sparql.Builder : Object { * Returns: the created SPARQL query. The string is contained in the * #TrackerSparqlBuilder object, and should not be freed by the caller. * - * Since: 0.8 + * Since: 0.10 */ /** * TrackerSparqlBuilder:result: * * String containing the constructed SPARQL in the #TrackerSparqlBuilder. + * + * Since: 0.10 */ public string result { get { @@ -115,13 +118,15 @@ public class Tracker.Sparql.Builder : Object { * * Returns: the number of objects contained. * - * Since: 0.8 + * Since: 0.10 */ /** * TrackerSparqlBuilder:length: * * Number of objects added to the #TrackerSparqlBuilder. + * + * Since: 0.10 */ public int length { get; @@ -136,13 +141,15 @@ public class Tracker.Sparql.Builder : Object { * * Returns: a #TrackerSparqlBuilderState defining the current state of @self * - * Since: 0.8 + * Since: 0.10 */ /** * TrackerSparqlBuilder:state: * * Current state of the #TrackerSparqlBuilder. + * + * Since: 0.10 */ public State state { get { return states[states.length - 1]; } @@ -188,7 +195,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a DROP GRAPH clause. * - * Since: 0.8 + * Since: 0.10 */ public void drop_graph (string iri) requires (state == State.UPDATE) @@ -203,7 +210,7 @@ public class Tracker.Sparql.Builder : Object { * * Opens an insertion statement. * - * Since: 0.8 + * Since: 0.10 */ public void insert_open (string? graph) requires (state == State.UPDATE) @@ -240,7 +247,7 @@ public class Tracker.Sparql.Builder : Object { * * Closes an insertion statement opened with tracker_sparql_builder_insert_open(). * - * Since: 0.8 + * Since: 0.10 */ public void insert_close () requires (state == State.INSERT || state == State.OBJECT) @@ -264,7 +271,7 @@ public class Tracker.Sparql.Builder : Object { * Opens a DELETE clause. Data triples may be appended in order to prepare * a query to delete them. * - * Since: 0.8 + * Since: 0.10 */ public void delete_open (string? graph) requires (state == State.UPDATE) @@ -282,7 +289,7 @@ public class Tracker.Sparql.Builder : Object { * * Closes a DELETE clause opened through tracker_sparql_builder_delete_open(). * - * Since: 0.8 + * Since: 0.10 */ public void delete_close () requires (state == State.DELETE || state == State.OBJECT) @@ -302,6 +309,8 @@ public class Tracker.Sparql.Builder : Object { * @graph: graph name. * * Opens a GRAPH clause within INSERT, DELETE, or WHERE. + * + * Since: 0.10 */ public void graph_open (string graph) requires (state == State.INSERT || state == State.DELETE || state == State.OBJECT || state == State.WHERE || state == State.GRAPH) @@ -315,6 +324,8 @@ public class Tracker.Sparql.Builder : Object { * @self: a #TrackerSparqlBuilder * * Closes a GRAPH clause opened through tracker_sparql_builder_graph_open(). + * + * Since: 0.10 */ public void graph_close () requires (state == State.GRAPH || state == State.OBJECT) @@ -335,7 +346,7 @@ public class Tracker.Sparql.Builder : Object { * Opens a WHERE clause. Data triples may be appended then to narrow the scope * to which the update query applies. * - * Since: 0.8 + * Since: 0.10 */ public void where_open () requires (state == State.UPDATE) @@ -350,7 +361,7 @@ public class Tracker.Sparql.Builder : Object { * * Closes a WHERE clause opened through tracker_sparql_builder_where_open(). * - * Since: 0.8 + * Since: 0.10 */ public void where_close () requires (state == State.WHERE || state == State.OBJECT) @@ -370,7 +381,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a subject as a SPARQL variable, such as "?urn". * - * Since: 0.8 + * Since: 0.10 */ public void subject_variable (string var_name) { subject ("?%s".printf (var_name)); @@ -383,7 +394,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends an object as a SparQL variable, such as "?urn". * - * Since: 0.8 + * Since: 0.10 */ public void object_variable (string var_name) { object ("?%s".printf (var_name)); @@ -397,7 +408,7 @@ public class Tracker.Sparql.Builder : Object { * Appends a subject as an IRI, such as "<urn:file:1234-5678>". IRIs * univocally identify a resource in tracker-store. * - * Since: 0.8 + * Since: 0.10 */ public void subject_iri (string iri) { subject ("<%s>".printf (iri)); @@ -410,7 +421,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a subject. * - * Since: 0.8 + * Since: 0.10 */ public void subject (string s) requires (state == State.INSERT || state == State.OBJECT || state == State.EMBEDDED_INSERT || state == State.DELETE || state == State.WHERE || state == State.GRAPH) @@ -430,7 +441,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a predicate as an IRI. * - * Since: 0.8 + * Since: 0.10 */ public void predicate_iri (string iri) { predicate ("<%s>".printf (iri)); @@ -443,7 +454,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a predicate for the previously appended subject. * - * Since: 0.8 + * Since: 0.10 */ public void predicate (string s) requires (state == State.SUBJECT || state == State.OBJECT || state == State.BLANK) @@ -464,7 +475,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends an object as an IRI. * - * Since: 0.8 + * Since: 0.10 */ public void object_iri (string iri) { object ("<%s>".printf (iri)); @@ -477,7 +488,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a free-form object for the previously appended subject and predicate. * - * Since: 0.8 + * Since: 0.10 */ public void object (string s) requires (state == State.PREDICATE || state == State.OBJECT) @@ -501,7 +512,7 @@ public class Tracker.Sparql.Builder : Object { * Appends an object formatted as an string. @literal will be escaped and surrounded * by double quotes. * - * Since: 0.8 + * Since: 0.10 */ public void object_string (string literal) requires (state == State.PREDICATE || state == State.OBJECT) @@ -554,7 +565,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a string not validated as UTF-8 as an object. * - * Since: 0.8 + * Since: 0.10 */ public void object_unvalidated (string value) { char* end; @@ -579,7 +590,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a #gboolean value as an object. * - * Since: 0.8 + * Since: 0.10 */ public void object_boolean (bool literal) { object (literal ? "true" : "false"); @@ -592,7 +603,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a #gint64 value as an object. * - * Since: 0.8 + * Since: 0.10 */ public void object_int64 (int64 literal) { object (literal.to_string ()); @@ -606,7 +617,7 @@ public class Tracker.Sparql.Builder : Object { * 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.8 + * Since: 0.10 */ public void object_date (ref time_t literal) { var tm = Time.gm (literal); @@ -621,7 +632,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends a #gdouble value as an object. * - * Since: 0.8 + * Since: 0.10 */ public void object_double (double literal) { object (literal.to_string ()); @@ -635,7 +646,7 @@ public class Tracker.Sparql.Builder : Object { * anonymous nodes for not previously known data without the need of a * separate insertion. * - * Since: 0.8 + * Since: 0.10 */ public void object_blank_open () requires (state == State.PREDICATE || state == State.OBJECT) @@ -654,7 +665,7 @@ public class Tracker.Sparql.Builder : Object { * * Closes an anomymous blank node opened with tracker_sparql_builder_object_blank_open() * - * Since: 0.8 + * Since: 0.10 */ public void object_blank_close () requires (state == State.OBJECT && states[states.length - 3] == state.BLANK) @@ -673,7 +684,7 @@ public class Tracker.Sparql.Builder : Object { * * Prepends raw, unvalidated content to @self. * - * Since: 0.8 + * Since: 0.10 */ public void prepend (string raw) { @@ -687,7 +698,7 @@ public class Tracker.Sparql.Builder : Object { * * Appends raw, unvalidated content to @self. * - * Since: 0.8 + * Since: 0.10 */ public void append (string raw) { |