mirror of
https://github.com/cookiengineer/audacity
synced 2025-06-08 08:02:39 +02:00
1056 lines
55 KiB
HTML
1056 lines
55 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>Query results</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
||
<link rel="start" href="index.html" title="Redland RDF Library Manual">
|
||
<link rel="up" href="reference-manual.html" title="Part II. Reference Manual">
|
||
<link rel="prev" href="redland-query.html" title="Querying">
|
||
<link rel="next" href="redland-serializer.html" title="Serializers">
|
||
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
<link rel="chapter" href="redland.html" title="Redland Overview">
|
||
<link rel="chapter" href="introduction.html" title="Introduction">
|
||
<link rel="part" href="tutorial.html" title="Part I. Tutorial">
|
||
<link rel="part" href="reference-manual.html" title="Part II. Reference Manual">
|
||
<link rel="chapter" href="objects.html" title="Objects in C">
|
||
<link rel="chapter" href="redland-storage-modules.html" title="Storage Modules">
|
||
<link rel="index" href="indexes.html" title="Index">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
||
<tr valign="middle">
|
||
<td><a accesskey="p" href="redland-query.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="u" href="reference-manual.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
||
<th width="100%" align="center">Redland RDF Library Manual</th>
|
||
<td><a accesskey="n" href="redland-serializer.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
||
</tr>
|
||
<tr><td colspan="5" class="shortcuts"><nobr><a href="#redland-query-results.synopsis" class="shortcut">Top</a>
|
||
|
|
||
<a href="#redland-query-results.description" class="shortcut">Description</a></nobr></td></tr>
|
||
</table>
|
||
<div class="refentry" lang="en">
|
||
<a name="redland-query-results"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="redland-query-results.top_of_page"></a>Query results</span></h2>
|
||
<p>Query results — RDF query results.</p>
|
||
</td>
|
||
<td valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsynopsisdiv">
|
||
<a name="redland-query-results.synopsis"></a><h2>Synopsis</h2>
|
||
<pre class="synopsis">
|
||
typedef <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a>;
|
||
<a class="link" href="redland-stream.html#librdf-stream" title="librdf_stream">librdf_stream</a>* <a class="link" href="redland-query-results.html#librdf-query-results-as-stream" title="librdf_query_results_as_stream ()">librdf_query_results_as_stream</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-get-count" title="librdf_query_results_get_count ()">librdf_query_results_get_count</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-next" title="librdf_query_results_next ()">librdf_query_results_next</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-finished" title="librdf_query_results_finished ()">librdf_query_results_finished</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-get-bindings" title="librdf_query_results_get_bindings ()">librdf_query_results_get_bindings</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char ***names,
|
||
<a class="link" href="redland-node.html#librdf-node" title="librdf_node">librdf_node</a> **values);
|
||
<a class="link" href="redland-node.html#librdf-node" title="librdf_node">librdf_node</a>* <a class="link" href="redland-query-results.html#librdf-query-results-get-binding-value" title="librdf_query_results_get_binding_value ()">librdf_query_results_get_binding_value</a>
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
int offset);
|
||
const char* <a class="link" href="redland-query-results.html#librdf-query-results-get-binding-name" title="librdf_query_results_get_binding_name ()">librdf_query_results_get_binding_name</a>
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
int offset);
|
||
<a class="link" href="redland-node.html#librdf-node" title="librdf_node">librdf_node</a>* <a class="link" href="redland-query-results.html#librdf-query-results-get-binding-value-by-name" title="librdf_query_results_get_binding_value_by_name ()">librdf_query_results_get_binding_value_by_name</a>
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char *name);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-get-bindings-count" title="librdf_query_results_get_bindings_count ()">librdf_query_results_get_bindings_count</a>
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
unsigned char* <a class="link" href="redland-query-results.html#librdf-query-results-to-counted-string" title="librdf_query_results_to_counted_string ()">librdf_query_results_to_counted_string</a>
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *format_uri,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri,
|
||
size_t *length_p);
|
||
unsigned char* <a class="link" href="redland-query-results.html#librdf-query-results-to-string" title="librdf_query_results_to_string ()">librdf_query_results_to_string</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *format_uri,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-to-file-handle" title="librdf_query_results_to_file_handle ()">librdf_query_results_to_file_handle</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
FILE *handle,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *format_uri,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-to-file" title="librdf_query_results_to_file ()">librdf_query_results_to_file</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char *name,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *format_uri,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri);
|
||
void <a class="link" href="redland-query-results.html#librdf-free-query-results" title="librdf_free_query_results ()">librdf_free_query_results</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-is-bindings" title="librdf_query_results_is_bindings ()">librdf_query_results_is_bindings</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-is-boolean" title="librdf_query_results_is_boolean ()">librdf_query_results_is_boolean</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-is-graph" title="librdf_query_results_is_graph ()">librdf_query_results_is_graph</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-is-syntax" title="librdf_query_results_is_syntax ()">librdf_query_results_is_syntax</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-get-boolean" title="librdf_query_results_get_boolean ()">librdf_query_results_get_boolean</a> (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);
|
||
<a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a>* <a class="link" href="redland-query-results.html#librdf-new-query-results-formatter" title="librdf_new_query_results_formatter ()">librdf_new_query_results_formatter</a>
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char *name,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *uri);
|
||
<a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a>* <a class="link" href="redland-query-results.html#librdf-new-query-results-formatter-by-mime-type" title="librdf_new_query_results_formatter_by_mime_type ()">librdf_new_query_results_formatter_by_mime_type</a>
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char *mime_type);
|
||
void <a class="link" href="redland-query-results.html#librdf-free-query-results-formatter" title="librdf_free_query_results_formatter ()">librdf_free_query_results_formatter</a> (<a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a> *formatter);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-formats-check" title="librdf_query_results_formats_check ()">librdf_query_results_formats_check</a> (<a class="link" href="redland-world.html#librdf-world" title="librdf_world">librdf_world</a> *world,
|
||
const char *name,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *uri,
|
||
const char *mime_type);
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-formats-enumerate" title="librdf_query_results_formats_enumerate ()">librdf_query_results_formats_enumerate</a>
|
||
(<a class="link" href="redland-world.html#librdf-world" title="librdf_world">librdf_world</a> *world,
|
||
unsigned int counter,
|
||
const char **name,
|
||
const char **label,
|
||
unsigned char **uri_string,
|
||
const char **mime_type);
|
||
typedef <a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a>;
|
||
int <a class="link" href="redland-query-results.html#librdf-query-results-formatter-write" title="librdf_query_results_formatter_write ()">librdf_query_results_formatter_write</a>
|
||
(<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-iostream.html#raptor-iostream"
|
||
>raptor_iostream</a> *iostr,
|
||
<a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a> *formatter,
|
||
<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *results,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri);
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<a name="redland-query-results.description"></a><h2>Description</h2>
|
||
<p>
|
||
The results of an <a class="link" href="redland-query.html#librdf-query" title="librdf_query"><span class="type">librdf_query</span></a> execution as a sequence of individual
|
||
results, an RDF graph as a sequence of triples or a boolean. For
|
||
variable binding results, the binding names and values can be read in
|
||
multiple forms and the number of results returned as well as the
|
||
current result moved to the next. For an RDF graph result, the
|
||
stream of triples can be returned. For a boolean result, the value
|
||
can be returned. All results can be turned into a string XML format
|
||
based on the SPARQL XML results format which can also be written to a file.
|
||
</p>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<a name="redland-query-results.details"></a><h2>Details</h2>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results"></a><h3>librdf_query_results</h3>
|
||
<pre class="programlisting">typedef struct librdf_query_results_s librdf_query_results;
|
||
</pre>
|
||
<p>
|
||
Redland query results class.</p>
|
||
<p>
|
||
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-as-stream"></a><h3>librdf_query_results_as_stream ()</h3>
|
||
<pre class="programlisting"><a class="link" href="redland-stream.html#librdf-stream" title="librdf_stream">librdf_stream</a>* librdf_query_results_as_stream (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Get a query result as an RDF graph in <a class="link" href="redland-stream.html#librdf-stream" title="librdf_stream"><span class="type">librdf_stream</span></a> form
|
||
</p>
|
||
<p>
|
||
The return value is only meaningful if this is an RDF graph
|
||
query result - see <a class="link" href="redland-query-results.html#librdf-query-results-is-graph" title="librdf_query_results_is_graph ()"><span class="type">librdf_query_results_is_graph</span></a></p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query_results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a new <a class="link" href="redland-stream.html#librdf-stream" title="librdf_stream"><span class="type">librdf_stream</span></a> result or NULL on error
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-get-count"></a><h3>librdf_query_results_get_count ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_get_count (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Get number of bindings so far.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> number of bindings found so far
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-next"></a><h3>librdf_query_results_next ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_next (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Move to the next result.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if failed or results exhausted
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-finished"></a><h3>librdf_query_results_finished ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_finished (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Find out if binding results are exhausted.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if results are finished or query failed
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-get-bindings"></a><h3>librdf_query_results_get_bindings ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_get_bindings (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char ***names,
|
||
<a class="link" href="redland-node.html#librdf-node" title="librdf_node">librdf_node</a> **values);</pre>
|
||
<p>
|
||
Get all binding names, values for current result.
|
||
</p>
|
||
<p>
|
||
If names is not NULL, it is set to the address of a shared array
|
||
of names of the bindings (an output parameter). These names
|
||
are shared and must not be freed by the caller
|
||
</p>
|
||
<p>
|
||
If values is not NULL, it is used as an array to store pointers
|
||
to the librdf_node* of the results. These nodes must be freed
|
||
by the caller. The size of the array is determined by the
|
||
number of names of bindings, returned by
|
||
librdf_query_get_bindings_count dynamically or
|
||
will be known in advanced if hard-coded into the query string.
|
||
</p>
|
||
<p>
|
||
Example
|
||
</p>
|
||
<p>
|
||
const char **names=NULL;
|
||
librdf_node* values[10];
|
||
</p>
|
||
<p>
|
||
if(librdf_query_results_get_bindings(results, &names, values))
|
||
...</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>names</code></em> :</span></p></td>
|
||
<td> pointer to an array of binding names (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>values</code></em> :</span></p></td>
|
||
<td> pointer to an array of binding value <a class="link" href="redland-node.html#librdf-node" title="librdf_node"><span class="type">librdf_node</span></a> (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if the assignment failed
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-get-binding-value"></a><h3>librdf_query_results_get_binding_value ()</h3>
|
||
<pre class="programlisting"><a class="link" href="redland-node.html#librdf-node" title="librdf_node">librdf_node</a>* librdf_query_results_get_binding_value
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
int offset);</pre>
|
||
<p>
|
||
Get one binding value for the current result.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
||
<td> offset of binding name into array of known names
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a new <a class="link" href="redland-node.html#librdf-node" title="librdf_node"><span class="type">librdf_node</span></a> binding value or NULL on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-get-binding-name"></a><h3>librdf_query_results_get_binding_name ()</h3>
|
||
<pre class="programlisting">const char* librdf_query_results_get_binding_name
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
int offset);</pre>
|
||
<p>
|
||
Get binding name for the current result.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
||
<td> offset of binding name into array of known names
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a pointer to a shared copy of the binding name or NULL on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-get-binding-value-by-name"></a><h3>librdf_query_results_get_binding_value_by_name ()</h3>
|
||
<pre class="programlisting"><a class="link" href="redland-node.html#librdf-node" title="librdf_node">librdf_node</a>* librdf_query_results_get_binding_value_by_name
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char *name);</pre>
|
||
<p>
|
||
Get one binding value for a given name in the current result.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
||
<td> variable name
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a new <a class="link" href="redland-node.html#librdf-node" title="librdf_node"><span class="type">librdf_node</span></a> binding value or NULL on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-get-bindings-count"></a><h3>librdf_query_results_get_bindings_count ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_get_bindings_count
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Get the number of bound variables in the result.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> <0 if failed or results exhausted
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-to-counted-string"></a><h3>librdf_query_results_to_counted_string ()</h3>
|
||
<pre class="programlisting">unsigned char* librdf_query_results_to_counted_string
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *format_uri,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri,
|
||
size_t *length_p);</pre>
|
||
<p>
|
||
Turn a query results into a string.
|
||
</p>
|
||
<p>
|
||
Values of format_uri currently supported (via Rasqal) are:
|
||
http://www.w3.org/TR/2004/WD-rdf-sparql-XMLres-20041221/
|
||
</p>
|
||
<p>
|
||
The base URI may be used for the generated syntax, depending
|
||
on the format.
|
||
</p>
|
||
<p>
|
||
The returned string must be freed by the caller</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>format_uri</code></em> :</span></p></td>
|
||
<td> URI of syntax to format to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>base_uri</code></em> :</span></p></td>
|
||
<td> Base URI of output formatted syntax or NULL
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>length_p</code></em> :</span></p></td>
|
||
<td> Pointer to where to store length of string or NULL
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> new string value or NULL on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-to-string"></a><h3>librdf_query_results_to_string ()</h3>
|
||
<pre class="programlisting">unsigned char* librdf_query_results_to_string (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *format_uri,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri);</pre>
|
||
<p>
|
||
Turn a query results into a string.
|
||
</p>
|
||
<p>
|
||
See librdf_query_results_to_counted_string for information on the
|
||
format_uri and base_uri parameters.
|
||
</p>
|
||
<p>
|
||
The returned string must be freed by the caller</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>format_uri</code></em> :</span></p></td>
|
||
<td> URI of syntax to format to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>base_uri</code></em> :</span></p></td>
|
||
<td> Base URI of output formatted syntax
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> new string value or NULL on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-to-file-handle"></a><h3>librdf_query_results_to_file_handle ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_to_file_handle (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
FILE *handle,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *format_uri,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri);</pre>
|
||
<p>
|
||
Write a query results to a FILE*.
|
||
</p>
|
||
<p>
|
||
See librdf_query_results_to_counted_string for information on the
|
||
format_uri and base_uri parameters.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>handle</code></em> :</span></p></td>
|
||
<td> file handle to write to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>format_uri</code></em> :</span></p></td>
|
||
<td> URI of syntax to format to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>base_uri</code></em> :</span></p></td>
|
||
<td> Base URI of output formatted syntax
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non 0 on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-to-file"></a><h3>librdf_query_results_to_file ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_to_file (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char *name,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *format_uri,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri);</pre>
|
||
<p>
|
||
Write a query results to a file.
|
||
</p>
|
||
<p>
|
||
See librdf_query_results_to_counted_string for information on the
|
||
format_uri and base_uri parameters.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
||
<td> filename to write to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>format_uri</code></em> :</span></p></td>
|
||
<td> URI of syntax to format to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>base_uri</code></em> :</span></p></td>
|
||
<td> Base URI of output formatted syntax
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non 0 on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-free-query-results"></a><h3>librdf_free_query_results ()</h3>
|
||
<pre class="programlisting">void librdf_free_query_results (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Destructor - destroy a <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody><tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-is-bindings"></a><h3>librdf_query_results_is_bindings ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_is_bindings (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Test if librdf_query_results is variable bindings format.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if true
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-is-boolean"></a><h3>librdf_query_results_is_boolean ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_is_boolean (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Test if librdf_query_results is boolean format.
|
||
</p>
|
||
<p>
|
||
If this function returns true, the result can be retrieved by
|
||
<a class="link" href="redland-query-results.html#librdf-query-results-get-boolean" title="librdf_query_results_get_boolean ()"><code class="function">librdf_query_results_get_boolean()</code></a>.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if true
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-is-graph"></a><h3>librdf_query_results_is_graph ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_is_graph (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Test if librdf_query_results is RDF graph format.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if true
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-is-syntax"></a><h3>librdf_query_results_is_syntax ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_is_syntax (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Test if librdf_query_results is a syntax.
|
||
</p>
|
||
<p>
|
||
If this function returns true, the ONLY result available
|
||
from this query is a syntax that can be serialized using
|
||
one of the <span class="type">query_result_formatter</span> class methods or with
|
||
<a class="link" href="redland-query-results.html#librdf-query-results-to-counted-string" title="librdf_query_results_to_counted_string ()"><code class="function">librdf_query_results_to_counted_string()</code></a>, <a class="link" href="redland-query-results.html#librdf-query-results-to-string" title="librdf_query_results_to_string ()"><code class="function">librdf_query_results_to_string()</code></a>,
|
||
<a class="link" href="redland-query-results.html#librdf-query-results-to-file-handle" title="librdf_query_results_to_file_handle ()"><code class="function">librdf_query_results_to_file_handle()</code></a> or <a class="link" href="redland-query-results.html#librdf-query-results-to-file" title="librdf_query_results_to_file ()"><code class="function">librdf_query_results_to_file()</code></a></p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if true
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-get-boolean"></a><h3>librdf_query_results_get_boolean ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_get_boolean (<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results);</pre>
|
||
<p>
|
||
Get boolean query result.
|
||
</p>
|
||
<p>
|
||
The return value is only meaningful if this is a boolean
|
||
query result - see <a class="link" href="redland-query-results.html#librdf-query-results-is-boolean" title="librdf_query_results_is_boolean ()"><span class="type">librdf_query_results_is_boolean</span></a></p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query_results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> boolean query result - >0 is true, 0 is false, <0 on error or finished
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-new-query-results-formatter"></a><h3>librdf_new_query_results_formatter ()</h3>
|
||
<pre class="programlisting"><a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a>* librdf_new_query_results_formatter
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char *name,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *uri);</pre>
|
||
<p>
|
||
Constructor - create a new librdf_query_results_formatter object by identified format.
|
||
</p>
|
||
<p>
|
||
A query results format can be named or identified by a URI, both
|
||
of which are optional. The default query results format will be used
|
||
if both are NULL. <a class="link" href="redland-query-results.html#librdf-query-results-formats-enumerate" title="librdf_query_results_formats_enumerate ()"><code class="function">librdf_query_results_formats_enumerate()</code></a> returns
|
||
information on the known query results names, labels and URIs.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query_results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
||
<td> the query results format name (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri"><span class="type">librdf_uri</span></a> query results format uri (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a new <a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter"><span class="type">librdf_query_results_formatter</span></a> object or NULL on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-new-query-results-formatter-by-mime-type"></a><h3>librdf_new_query_results_formatter_by_mime_type ()</h3>
|
||
<pre class="programlisting"><a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a>* librdf_new_query_results_formatter_by_mime_type
|
||
(<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *query_results,
|
||
const char *mime_type);</pre>
|
||
<p>
|
||
Constructor - create a new librdf_query_results_formatter object by mime type.
|
||
</p>
|
||
<p>
|
||
A query results format generates a syntax with a mime type which
|
||
may be requested with this constructor.
|
||
</p>
|
||
<p>
|
||
Note that there may be several formatters that generate the same
|
||
MIME Type (such as SPARQL XML results format drafts) and in thot
|
||
case the <a class="link" href="redland-query-results.html#librdf-new-query-results-formatter" title="librdf_new_query_results_formatter ()"><code class="function">librdf_new_query_results_formatter()</code></a> constructor allows
|
||
selecting of a specific one by name or URI.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query_results
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td>
|
||
<td> mime type name
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a new <a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter"><span class="type">librdf_query_results_formatter</span></a> object or NULL on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-free-query-results-formatter"></a><h3>librdf_free_query_results_formatter ()</h3>
|
||
<pre class="programlisting">void librdf_free_query_results_formatter (<a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a> *formatter);</pre>
|
||
<p>
|
||
Destructor - destroy a <a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter"><span class="type">librdf_query_results_formatter</span></a> object.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody><tr>
|
||
<td><p><span class="term"><em class="parameter"><code>formatter</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter"><span class="type">librdf_query_results_formatter</span></a> object
|
||
</td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-formats-check"></a><h3>librdf_query_results_formats_check ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_formats_check (<a class="link" href="redland-world.html#librdf-world" title="librdf_world">librdf_world</a> *world,
|
||
const char *name,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *uri,
|
||
const char *mime_type);</pre>
|
||
<p>
|
||
Check if a query results formatter exists for the requested format.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-world.html#librdf-world" title="librdf_world"><span class="type">librdf_world</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
||
<td> the query results format name (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri"><span class="type">librdf_uri</span></a> query results format uri (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td>
|
||
<td> mime type name
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if a formatter exists.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-formats-enumerate"></a><h3>librdf_query_results_formats_enumerate ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_formats_enumerate
|
||
(<a class="link" href="redland-world.html#librdf-world" title="librdf_world">librdf_world</a> *world,
|
||
unsigned int counter,
|
||
const char **name,
|
||
const char **label,
|
||
unsigned char **uri_string,
|
||
const char **mime_type);</pre>
|
||
<p>
|
||
Get information on query result syntaxes.
|
||
</p>
|
||
<p>
|
||
All returned strings are shared and must be copied if needed to be
|
||
used dynamically.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-world.html#librdf-world" title="librdf_world"><span class="type">librdf_world</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>counter</code></em> :</span></p></td>
|
||
<td> index into the list of query result syntaxes
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
||
<td> pointer to store the name of the query result syntax (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>label</code></em> :</span></p></td>
|
||
<td> pointer to store query result syntax readable label (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>uri_string</code></em> :</span></p></td>
|
||
<td> pointer to store query result syntax URI string (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>mime_type</code></em> :</span></p></td>
|
||
<td> pointer to store query result syntax mime type string (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non 0 on failure of if counter is out of range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-formatter"></a><h3>librdf_query_results_formatter</h3>
|
||
<pre class="programlisting">typedef struct librdf_query_results_formatter_s librdf_query_results_formatter;
|
||
</pre>
|
||
<p>
|
||
Redland query results formatter class.</p>
|
||
<p>
|
||
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="librdf-query-results-formatter-write"></a><h3>librdf_query_results_formatter_write ()</h3>
|
||
<pre class="programlisting">int librdf_query_results_formatter_write
|
||
(<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-iostream.html#raptor-iostream"
|
||
>raptor_iostream</a> *iostr,
|
||
<a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter">librdf_query_results_formatter</a> *formatter,
|
||
<a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results">librdf_query_results</a> *results,
|
||
<a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri">librdf_uri</a> *base_uri);</pre>
|
||
<p>
|
||
Write the query results using the given formatter to an iostream
|
||
</p>
|
||
<p>
|
||
See <a class="link" href="redland-query-results.html#librdf-query-results-formats-enumerate" title="librdf_query_results_formats_enumerate ()"><code class="function">librdf_query_results_formats_enumerate()</code></a> to get the
|
||
list of syntax URIs and their description.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>iostr</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-iostream.html#raptor-iostream"
|
||
><span class="type">raptor_iostream</span></a> to write the query to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>formatter</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results-formatter" title="librdf_query_results_formatter"><span class="type">librdf_query_results_formatter</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>results</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-query-results.html#librdf-query-results" title="librdf_query_results"><span class="type">librdf_query_results</span></a> query results format
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>base_uri</code></em> :</span></p></td>
|
||
<td> <a class="link" href="redland-uri.html#librdf-uri" title="librdf_uri"><span class="type">librdf_uri</span></a> base URI of the output format
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>
|
||
Generated by GTK-Doc V1.10</div>
|
||
</body>
|
||
</html>
|