mirror of
https://github.com/cookiengineer/audacity
synced 2025-05-11 06:31:07 +02:00
2212 lines
108 KiB
HTML
2212 lines
108 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</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
|
||
<link rel="start" href="index.html" title="Rasqal RDF Query Library Manual">
|
||
<link rel="up" href="pt01.html" title="Part I. Reference Manual">
|
||
<link rel="prev" href="rasqal-section-prefix.html" title="Prefixes">
|
||
<link rel="next" href="rasqal-section-query-results.html" title="Query Results">
|
||
<meta name="generator" content="GTK-Doc V1.10 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
<link rel="chapter" href="rasqal.html" title="Rasqal Overview">
|
||
<link rel="part" href="pt01.html" title="Part I. Reference Manual">
|
||
<link rel="index" href="ix01.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="rasqal-section-prefix.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="u" href="pt01.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">Rasqal RDF Query Library Manual</th>
|
||
<td><a accesskey="n" href="rasqal-section-query-results.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="#rasqal-section-query.synopsis" class="shortcut">Top</a>
|
||
|
|
||
<a href="#rasqal-section-query.description" class="shortcut">Description</a></nobr></td></tr>
|
||
</table>
|
||
<div class="refentry" lang="en">
|
||
<a name="rasqal-section-query"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="rasqal-section-query.top_of_page"></a>Query</span></h2>
|
||
<p>Query — Query object API, parsing and execution</p>
|
||
</td>
|
||
<td valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsynopsisdiv">
|
||
<a name="rasqal-section-query.synopsis"></a><h2>Synopsis</h2>
|
||
<pre class="synopsis">
|
||
enum <a class="link" href="rasqal-section-query.html#rasqal-query-verb" title="enum rasqal_query_verb">rasqal_query_verb</a>;
|
||
typedef <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a>;
|
||
<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a>* <a class="link" href="rasqal-section-query.html#rasqal-new-query" title="rasqal_new_query ()">rasqal_new_query</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
|
||
const char *name,
|
||
unsigned char *uri);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-free-query" title="rasqal_free_query ()">rasqal_free_query</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-add-data-graph" title="rasqal_query_add_data_graph ()">rasqal_query_add_data_graph</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *uri,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *name_uri,
|
||
int flags);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-add-prefix" title="rasqal_query_add_prefix ()">rasqal_query_add_prefix</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-prefix.html#rasqal-prefix" title="rasqal_prefix">rasqal_prefix</a> *prefix);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-add-variable" title="rasqal_query_add_variable ()">rasqal_query_add_variable</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable">rasqal_variable</a> *var);
|
||
<a class="link" href="rasqal-section-query-results.html#rasqal-query-results" title="rasqal_query_results">rasqal_query_results</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-execute" title="rasqal_query_execute ()">rasqal_query_execute</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-all-variable-sequence" title="rasqal_query_get_all_variable_sequence ()">rasqal_query_get_all_variable_sequence</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-anonymous-variable-sequence" title="rasqal_query_get_anonymous_variable_sequence ()">rasqal_query_get_anonymous_variable_sequence</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-bound-variable-sequence" title="rasqal_query_get_bound_variable_sequence ()">rasqal_query_get_bound_variable_sequence</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-triple.html#rasqal-triple" title="rasqal_triple">rasqal_triple</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-construct-triple" title="rasqal_query_get_construct_triple ()">rasqal_query_get_construct_triple</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-construct-triples-sequence" title="rasqal_query_get_construct_triples_sequence ()">rasqal_query_get_construct_triples_sequence</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-data.html#rasqal-data-graph" title="rasqal_data_graph">rasqal_data_graph</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-data-graph" title="rasqal_query_get_data_graph ()">rasqal_query_get_data_graph</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-data-graph-sequence" title="rasqal_query_get_data_graph_sequence ()">rasqal_query_get_data_graph_sequence</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-get-distinct" title="rasqal_query_get_distinct ()">rasqal_query_get_distinct</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-get-explain" title="rasqal_query_get_explain ()">rasqal_query_get_explain</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-expression.html#rasqal-expression" title="rasqal_expression">rasqal_expression</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-group-condition" title="rasqal_query_get_group_condition ()">rasqal_query_get_group_condition</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-group-conditions-sequence" title="rasqal_query_get_group_conditions_sequence ()">rasqal_query_get_group_conditions_sequence</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern" title="rasqal_graph_pattern">rasqal_graph_pattern</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-graph-pattern" title="rasqal_query_get_graph_pattern ()">rasqal_query_get_graph_pattern</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-graph-pattern-sequence" title="rasqal_query_get_graph_pattern_sequence ()">rasqal_query_get_graph_pattern_sequence</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
const char* <a class="link" href="rasqal-section-query.html#rasqal-query-get-label" title="rasqal_query_get_label ()">rasqal_query_get_label</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-get-limit" title="rasqal_query_get_limit ()">rasqal_query_get_limit</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
const char* <a class="link" href="rasqal-section-query.html#rasqal-query-get-name" title="rasqal_query_get_name ()">rasqal_query_get_name</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-get-offset" title="rasqal_query_get_offset ()">rasqal_query_get_offset</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-expression.html#rasqal-expression" title="rasqal_expression">rasqal_expression</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-order-condition" title="rasqal_query_get_order_condition ()">rasqal_query_get_order_condition</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-order-conditions-sequence" title="rasqal_query_get_order_conditions_sequence ()">rasqal_query_get_order_conditions_sequence</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-prefix.html#rasqal-prefix" title="rasqal_prefix">rasqal_prefix</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-prefix" title="rasqal_query_get_prefix ()">rasqal_query_get_prefix</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-prefix-sequence" title="rasqal_query_get_prefix_sequence ()">rasqal_query_get_prefix_sequence</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern" title="rasqal_graph_pattern">rasqal_graph_pattern</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-query-graph-pattern" title="rasqal_query_get_query_graph_pattern ()">rasqal_query_get_query_graph_pattern</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-triple.html#rasqal-triple" title="rasqal_triple">rasqal_triple</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-triple" title="rasqal_query_get_triple ()">rasqal_query_get_triple</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-triple-sequence" title="rasqal_query_get_triple_sequence ()">rasqal_query_get_triple_sequence</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
void* <a class="link" href="rasqal-section-query.html#rasqal-query-get-user-data" title="rasqal_query_get_user_data ()">rasqal_query_get_user_data</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
<a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable">rasqal_variable</a>* <a class="link" href="rasqal-section-query.html#rasqal-query-get-variable" title="rasqal_query_get_variable ()">rasqal_query_get_variable</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);
|
||
<a class="link" href="rasqal-section-query.html#rasqal-query-verb" title="enum rasqal_query_verb">rasqal_query_verb</a> <a class="link" href="rasqal-section-query.html#rasqal-query-get-verb" title="rasqal_query_get_verb ()">rasqal_query_get_verb</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-get-wildcard" title="rasqal_query_get_wildcard ()">rasqal_query_get_wildcard</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-has-variable" title="rasqal_query_has_variable ()">rasqal_query_has_variable</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
unsigned char *name);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-prepare" title="rasqal_query_prepare ()">rasqal_query_prepare</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
unsigned char *query_string,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *base_uri);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-print" title="rasqal_query_print ()">rasqal_query_print</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
FILE *fh);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-graph-pattern-visit" title="rasqal_query_graph_pattern_visit ()">rasqal_query_graph_pattern_visit</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern-visit-fn" title="rasqal_graph_pattern_visit_fn ()">rasqal_graph_pattern_visit_fn</a> visit_fn,
|
||
void *data);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-default-generate-bnodeid-parameters" title="rasqal_query_set_default_generate_bnodeid_parameters ()">rasqal_query_set_default_generate_bnodeid_parameters</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *rdf_query,
|
||
char *prefix,
|
||
int base);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-distinct" title="rasqal_query_set_distinct ()">rasqal_query_set_distinct</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int distinct_mode);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-explain" title="rasqal_query_set_explain ()">rasqal_query_set_explain</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int is_explain);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-error-handler" title="rasqal_query_set_error_handler ()">rasqal_query_set_error_handler</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-general.html#raptor-message-handler"
|
||
>raptor_message_handler</a> handler);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-fatal-error-handler" title="rasqal_query_set_fatal_error_handler ()">rasqal_query_set_fatal_error_handler</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-general.html#raptor-message-handler"
|
||
>raptor_message_handler</a> handler);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-generate-bnodeid-handler" title="rasqal_query_set_generate_bnodeid_handler ()">rasqal_query_set_generate_bnodeid_handler</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data,
|
||
rasqal_generate_bnodeid_handler handler);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-limit" title="rasqal_query_set_limit ()">rasqal_query_set_limit</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int limit);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-offset" title="rasqal_query_set_offset ()">rasqal_query_set_offset</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int offset);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-user-data" title="rasqal_query_set_user_data ()">rasqal_query_set_user_data</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-set-variable" title="rasqal_query_set_variable ()">rasqal_query_set_variable</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
unsigned char *name,
|
||
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *value);
|
||
void <a class="link" href="rasqal-section-query.html#rasqal-query-set-warning-handler" title="rasqal_query_set_warning_handler ()">rasqal_query_set_warning_handler</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-general.html#raptor-message-handler"
|
||
>raptor_message_handler</a> handler);
|
||
const char* <a class="link" href="rasqal-section-query.html#rasqal-query-verb-as-string" title="rasqal_query_verb_as_string ()">rasqal_query_verb_as_string</a> (<a class="link" href="rasqal-section-query.html#rasqal-query-verb" title="enum rasqal_query_verb">rasqal_query_verb</a> verb);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-write" title="rasqal_query_write ()">rasqal_query_write</a> (<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-iostream.html#raptor-iostream"
|
||
>raptor_iostream</a> *iostr,
|
||
<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *format_uri,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *base_uri);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-iostream-write-escaped-counted-string" title="rasqal_query_iostream_write_escaped_counted_string ()">rasqal_query_iostream_write_escaped_counted_string</a>
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-iostream.html#raptor-iostream"
|
||
>raptor_iostream</a> *iostr,
|
||
unsigned char *string,
|
||
size_t len);
|
||
unsigned char* <a class="link" href="rasqal-section-query.html#rasqal-query-escape-counted-string" title="rasqal_query_escape_counted_string ()">rasqal_query_escape_counted_string</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
unsigned char *string,
|
||
size_t len,
|
||
size_t *output_len_p);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-set-feature" title="rasqal_query_set_feature ()">rasqal_query_set_feature</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature">rasqal_feature</a> feature,
|
||
int value);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-set-feature-string" title="rasqal_query_set_feature_string ()">rasqal_query_set_feature_string</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature">rasqal_feature</a> feature,
|
||
unsigned char *value);
|
||
int <a class="link" href="rasqal-section-query.html#rasqal-query-get-feature" title="rasqal_query_get_feature ()">rasqal_query_get_feature</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature">rasqal_feature</a> feature);
|
||
const unsigned char* <a class="link" href="rasqal-section-query.html#rasqal-query-get-feature-string" title="rasqal_query_get_feature_string ()">rasqal_query_get_feature_string</a> (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature">rasqal_feature</a> feature);
|
||
</pre>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<a name="rasqal-section-query.description"></a><h2>Description</h2>
|
||
<p>
|
||
This class provides the main interface to the library. A query
|
||
can be constructed by parsing a string, retrieving it from a URI
|
||
and/or constructing it via API methods to build the query expression.
|
||
</p>
|
||
<p>The query structures can be read via methods to return
|
||
the query verb <a class="link" href="rasqal-section-query.html#rasqal-query-get-verb" title="rasqal_query_get_verb ()"><code class="function">rasqal_query_get_verb()</code></a>,
|
||
the <a class="link" href="rasqal-section-data.html#rasqal-data-graph" title="rasqal_data_graph"><span class="type">rasqal_data_graph</span></a> RDF data sources with <a class="link" href="rasqal-section-query.html#rasqal-query-get-data-graph" title="rasqal_query_get_data_graph ()"><code class="function">rasqal_query_get_data_graph()</code></a> etc.,
|
||
the <a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern" title="rasqal_graph_pattern"><span class="type">rasqal_graph_pattern</span></a> tree with <a class="link" href="rasqal-section-query.html#rasqal-query-get-query-graph-pattern" title="rasqal_query_get_query_graph_pattern ()"><code class="function">rasqal_query_get_query_graph_pattern()</code></a>,
|
||
the sequence of order conditions with <a class="link" href="rasqal-section-query.html#rasqal-query-get-order-condition" title="rasqal_query_get_order_condition ()"><code class="function">rasqal_query_get_order_condition()</code></a> etc.,
|
||
the <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> selected to return with
|
||
<a class="link" href="rasqal-section-query.html#rasqal-query-get-bound-variable-sequence" title="rasqal_query_get_bound_variable_sequence ()"><code class="function">rasqal_query_get_bound_variable_sequence()</code></a> or <a class="link" href="rasqal-section-query.html#rasqal-query-get-all-variable-sequence" title="rasqal_query_get_all_variable_sequence ()"><code class="function">rasqal_query_get_all_variable_sequence()</code></a>,
|
||
and so on.
|
||
</p>
|
||
<p>
|
||
To process a query string, the <a class="link" href="rasqal-section-query.html#rasqal-query-prepare" title="rasqal_query_prepare ()"><code class="function">rasqal_query_prepare()</code></a> method
|
||
parses the query string in some query language and initialises
|
||
the <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> structures.
|
||
</p>
|
||
<p>
|
||
The query can be evaluated with the internal query engine against
|
||
some source of matches using <a class="link" href="rasqal-section-query.html#rasqal-query-execute" title="rasqal_query_execute ()"><code class="function">rasqal_query_execute()</code></a> to give an
|
||
<a class="link" href="rasqal-section-query-results.html#rasqal-query-results" title="rasqal_query_results"><span class="type">rasqal_query_results</span></a>. There are multiple forms of results that
|
||
can include variable bindings, a boolean or an RDF graph that
|
||
can be tested for with methods on <a class="link" href="rasqal-section-query-results.html#rasqal-query-results" title="rasqal_query_results"><span class="type">rasqal_query_results</span></a> and
|
||
then retrieved.
|
||
</p>
|
||
</div>
|
||
<div class="refsect1" lang="en">
|
||
<a name="rasqal-section-query.details"></a><h2>Details</h2>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-verb"></a><h3>enum rasqal_query_verb</h3>
|
||
<pre class="programlisting">typedef enum {
|
||
/* internal */
|
||
RASQAL_QUERY_VERB_UNKNOWN = 0,
|
||
RASQAL_QUERY_VERB_SELECT = 1,
|
||
RASQAL_QUERY_VERB_CONSTRUCT = 2,
|
||
RASQAL_QUERY_VERB_DESCRIBE = 3,
|
||
RASQAL_QUERY_VERB_ASK = 4,
|
||
RASQAL_QUERY_VERB_DELETE = 5,
|
||
RASQAL_QUERY_VERB_INSERT = 6,
|
||
|
||
/* internal */
|
||
RASQAL_QUERY_VERB_LAST=RASQAL_QUERY_VERB_INSERT
|
||
} rasqal_query_verb;
|
||
</pre>
|
||
<p>
|
||
Query main operation verbs describing the major type of query
|
||
being performed.</p>
|
||
<p>
|
||
|
||
</p>
|
||
<div class="variablelist"><table border="0">
|
||
<col align="left" valign="top">
|
||
<tbody>
|
||
<tr>
|
||
<td><p><a name="RASQAL-QUERY-VERB-UNKNOWN:CAPS"></a><span class="term"><code class="literal">RASQAL_QUERY_VERB_UNKNOWN</code></span></p></td>
|
||
<td> Internal
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><a name="RASQAL-QUERY-VERB-SELECT:CAPS"></a><span class="term"><code class="literal">RASQAL_QUERY_VERB_SELECT</code></span></p></td>
|
||
<td> RDQL/SPARQL query select verb.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><a name="RASQAL-QUERY-VERB-CONSTRUCT:CAPS"></a><span class="term"><code class="literal">RASQAL_QUERY_VERB_CONSTRUCT</code></span></p></td>
|
||
<td> SPARQL query construct verb.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><a name="RASQAL-QUERY-VERB-DESCRIBE:CAPS"></a><span class="term"><code class="literal">RASQAL_QUERY_VERB_DESCRIBE</code></span></p></td>
|
||
<td> SPARQL query describe verb.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><a name="RASQAL-QUERY-VERB-ASK:CAPS"></a><span class="term"><code class="literal">RASQAL_QUERY_VERB_ASK</code></span></p></td>
|
||
<td> SPARQL query ask verb.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><a name="RASQAL-QUERY-VERB-DELETE:CAPS"></a><span class="term"><code class="literal">RASQAL_QUERY_VERB_DELETE</code></span></p></td>
|
||
<td> LAQRS query delete verb.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><a name="RASQAL-QUERY-VERB-INSERT:CAPS"></a><span class="term"><code class="literal">RASQAL_QUERY_VERB_INSERT</code></span></p></td>
|
||
<td> LAQRS query insert verb.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><a name="RASQAL-QUERY-VERB-LAST:CAPS"></a><span class="term"><code class="literal">RASQAL_QUERY_VERB_LAST</code></span></p></td>
|
||
<td> Internal
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query"></a><h3>rasqal_query</h3>
|
||
<pre class="programlisting">rasqal_graph_query* query;
|
||
</pre>
|
||
<p>
|
||
Rasqal query class.</p>
|
||
<p>
|
||
|
||
</p>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-new-query"></a><h3>rasqal_new_query ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a>* rasqal_new_query (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
|
||
const char *name,
|
||
unsigned char *uri);</pre>
|
||
<p>
|
||
Constructor - create a new rasqal_query object.
|
||
</p>
|
||
<p>
|
||
A query language can be named or identified by a URI, either
|
||
of which is optional. The default query language will be used
|
||
if both are NULL. rasqal_languages_enumerate returns
|
||
information on the known 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>world</code></em> :</span></p></td>
|
||
<td> rasqal_world object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
||
<td> the query language name (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
><span class="type">raptor_uri</span></a> language 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="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> object or NULL on failure
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-free-query"></a><h3>rasqal_free_query ()</h3>
|
||
<pre class="programlisting">void rasqal_free_query (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Destructor - destroy a <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> object
|
||
</td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-add-data-graph"></a><h3>rasqal_query_add_data_graph ()</h3>
|
||
<pre class="programlisting">int rasqal_query_add_data_graph (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *uri,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *name_uri,
|
||
int flags);</pre>
|
||
<p>
|
||
Add a data graph to the query.
|
||
</p>
|
||
<p>
|
||
named_uri must be given if flags RASQAL_DATA_GRAPH_NAMED is set.
|
||
It is the name of the graph and also used as the base URI
|
||
when resolving any relative URIs for the graph in 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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
><span class="type">raptor_uri</span></a> source uri for retrieval
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>name_uri</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
><span class="type">raptor_uri</span></a> name uri (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
|
||
<td> RASQAL_DATA_GRAPH_NAMED or RASQAL_DATA_GRAPH_BACKGROUND
|
||
</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="rasqal-query-add-prefix"></a><h3>rasqal_query_add_prefix ()</h3>
|
||
<pre class="programlisting">int rasqal_query_add_prefix (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-prefix.html#rasqal-prefix" title="rasqal_prefix">rasqal_prefix</a> *prefix);</pre>
|
||
<p>
|
||
Add a namespace prefix to the query.
|
||
</p>
|
||
<p>
|
||
If the prefix has already been used, the old URI will be overridden.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>prefix</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-prefix.html#rasqal-prefix" title="rasqal_prefix"><span class="type">rasqal_prefix</span></a> namespace prefix, URI
|
||
</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="rasqal-query-add-variable"></a><h3>rasqal_query_add_variable ()</h3>
|
||
<pre class="programlisting">int rasqal_query_add_variable (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable">rasqal_variable</a> *var);</pre>
|
||
<p>
|
||
Add a binding variable to the query.
|
||
</p>
|
||
<p>
|
||
See also rasqal_query_set_variable which assigns or removes a value to
|
||
a previously added variable in the query.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>var</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> variable
|
||
</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="rasqal-query-execute"></a><h3>rasqal_query_execute ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-query-results.html#rasqal-query-results" title="rasqal_query_results">rasqal_query_results</a>* rasqal_query_execute (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Excute a query - run and return results.</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</code></em> :</span></p></td>
|
||
<td> the <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-query-results.html#rasqal-query-results" title="rasqal_query_results"><span class="type">rasqal_query_results</span></a> structure or NULL on failure.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-all-variable-sequence"></a><h3>rasqal_query_get_all_variable_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_all_variable_sequence
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of all variables mentioned in the query.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-anonymous-variable-sequence"></a><h3>rasqal_query_get_anonymous_variable_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_anonymous_variable_sequence
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of anonymous variables mentioned in the query.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-bound-variable-sequence"></a><h3>rasqal_query_get_bound_variable_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_bound_variable_sequence
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of variables to bind in the query.
|
||
</p>
|
||
<p>
|
||
This returns the sequence of variables that are explicitly chosen
|
||
via SELECT in RDQL, SPARQL. Or all variables mentioned with SELECT *</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-construct-triple"></a><h3>rasqal_query_get_construct_triple ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-triple.html#rasqal-triple" title="rasqal_triple">rasqal_triple</a>* rasqal_query_get_construct_triple (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);</pre>
|
||
<p>
|
||
Get a triple in the sequence of construct triples.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
|
||
<td> index into the sequence (0 or larger)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-triple.html#rasqal-triple" title="rasqal_triple"><span class="type">rasqal_triple</span></a> pointer or NULL if out of the sequence range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-construct-triples-sequence"></a><h3>rasqal_query_get_construct_triples_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_construct_triples_sequence
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of triples for a construct.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-triple.html#rasqal-triple" title="rasqal_triple"><span class="type">rasqal_triple</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-data-graph"></a><h3>rasqal_query_get_data_graph ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-data.html#rasqal-data-graph" title="rasqal_data_graph">rasqal_data_graph</a>* rasqal_query_get_data_graph (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);</pre>
|
||
<p>
|
||
Get a rasqal_data_graph* in the sequence of data_graphs.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
|
||
<td> index into the sequence (0 or larger)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-data.html#rasqal-data-graph" title="rasqal_data_graph"><span class="type">rasqal_data_graph</span></a> pointer or NULL if out of the sequence range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-data-graph-sequence"></a><h3>rasqal_query_get_data_graph_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_data_graph_sequence
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of data_graph 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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
><span class="type">raptor_uri</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-distinct"></a><h3>rasqal_query_get_distinct ()</h3>
|
||
<pre class="programlisting">int rasqal_query_get_distinct (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the query distinct mode
|
||
</p>
|
||
<p>
|
||
See <a class="link" href="rasqal-section-query.html#rasqal-query-set-distinct" title="rasqal_query_set_distinct ()"><code class="function">rasqal_query_set_distinct()</code></a> for the distinct modes.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if the results should be distinct
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-explain"></a><h3>rasqal_query_get_explain ()</h3>
|
||
<pre class="programlisting">int rasqal_query_get_explain (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the query explain results flag.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if the results should be explain
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-group-condition"></a><h3>rasqal_query_get_group_condition ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-expression.html#rasqal-expression" title="rasqal_expression">rasqal_expression</a>* rasqal_query_get_group_condition (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);</pre>
|
||
<p>
|
||
Get a query grouping expression in the sequence of query grouping conditions.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
|
||
<td> index into the sequence (0 or larger)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-expression.html#rasqal-expression" title="rasqal_expression"><span class="type">rasqal_expression</span></a> pointer or NULL if out of the sequence range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-group-conditions-sequence"></a><h3>rasqal_query_get_group_conditions_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_group_conditions_sequence
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of query grouping conditions.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-expression.html#rasqal-expression" title="rasqal_expression"><span class="type">rasqal_expression</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-graph-pattern"></a><h3>rasqal_query_get_graph_pattern ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern" title="rasqal_graph_pattern">rasqal_graph_pattern</a>* rasqal_query_get_graph_pattern (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);</pre>
|
||
<p>
|
||
Get a graph_pattern in the sequence of graph_pattern expressions in the top query graph pattern.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
|
||
<td> index into the sequence (0 or larger)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern" title="rasqal_graph_pattern"><span class="type">rasqal_graph_pattern</span></a> pointer or NULL if out of the sequence range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-graph-pattern-sequence"></a><h3>rasqal_query_get_graph_pattern_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_graph_pattern_sequence
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of graph_patterns expressions inside the top query graph pattern.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern" title="rasqal_graph_pattern"><span class="type">rasqal_graph_pattern</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-label"></a><h3>rasqal_query_get_label ()</h3>
|
||
<pre class="programlisting">const char* rasqal_query_get_label (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get a readable label for the query language.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> shared string label value
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-limit"></a><h3>rasqal_query_get_limit ()</h3>
|
||
<pre class="programlisting">int rasqal_query_get_limit (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the query-specified limit on results.
|
||
</p>
|
||
<p>
|
||
This is the limit given in the query on the number of results allowed.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> integer >=0 if a limit is given, otherwise <0
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-name"></a><h3>rasqal_query_get_name ()</h3>
|
||
<pre class="programlisting">const char* rasqal_query_get_name (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get a short name for the query language.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> shared string label value
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-offset"></a><h3>rasqal_query_get_offset ()</h3>
|
||
<pre class="programlisting">int rasqal_query_get_offset (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the query-specified offset on results.
|
||
</p>
|
||
<p>
|
||
This is the offset given in the query on the number of results allowed.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> integer >=0 if a offset is given, otherwise <0
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-order-condition"></a><h3>rasqal_query_get_order_condition ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-expression.html#rasqal-expression" title="rasqal_expression">rasqal_expression</a>* rasqal_query_get_order_condition (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);</pre>
|
||
<p>
|
||
Get a query ordering expression in the sequence of query ordering conditions.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
|
||
<td> index into the sequence (0 or larger)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-expression.html#rasqal-expression" title="rasqal_expression"><span class="type">rasqal_expression</span></a> pointer or NULL if out of the sequence range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-order-conditions-sequence"></a><h3>rasqal_query_get_order_conditions_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_order_conditions_sequence
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of query ordering conditions.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-expression.html#rasqal-expression" title="rasqal_expression"><span class="type">rasqal_expression</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-prefix"></a><h3>rasqal_query_get_prefix ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-prefix.html#rasqal-prefix" title="rasqal_prefix">rasqal_prefix</a>* rasqal_query_get_prefix (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);</pre>
|
||
<p>
|
||
Get a prefix in the sequence of namespsace prefixes in the query.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
|
||
<td> index into the sequence (0 or larger)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-prefix.html#rasqal-prefix" title="rasqal_prefix"><span class="type">rasqal_prefix</span></a> pointer or NULL if out of the sequence range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-prefix-sequence"></a><h3>rasqal_query_get_prefix_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_prefix_sequence (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of namespace prefixes in the query.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-prefix.html#rasqal-prefix" title="rasqal_prefix"><span class="type">rasqal_prefix</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-query-graph-pattern"></a><h3>rasqal_query_get_query_graph_pattern ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern" title="rasqal_graph_pattern">rasqal_graph_pattern</a>* rasqal_query_get_query_graph_pattern
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the top query graph pattern.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern" title="rasqal_graph_pattern"><span class="type">rasqal_graph_pattern</span></a> of the top query graph pattern
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-triple"></a><h3>rasqal_query_get_triple ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-triple.html#rasqal-triple" title="rasqal_triple">rasqal_triple</a>* rasqal_query_get_triple (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);</pre>
|
||
<p>
|
||
Get a triple in the sequence of matching triples in the query.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
|
||
<td> index into the sequence (0 or larger)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-triple.html#rasqal-triple" title="rasqal_triple"><span class="type">rasqal_triple</span></a> pointer or NULL if out of the sequence range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-triple-sequence"></a><h3>rasqal_query_get_triple_sequence ()</h3>
|
||
<pre class="programlisting"><a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
>raptor_sequence</a>* rasqal_query_get_triple_sequence (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the sequence of matching triples in the query.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-sequence.html#raptor-sequence"
|
||
><span class="type">raptor_sequence</span></a> of <a class="link" href="rasqal-section-triple.html#rasqal-triple" title="rasqal_triple"><span class="type">rasqal_triple</span></a> pointers.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-user-data"></a><h3>rasqal_query_get_user_data ()</h3>
|
||
<pre class="programlisting">void* rasqal_query_get_user_data (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get query user data.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> user data as set by rasqal_query_set_user_data
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-variable"></a><h3>rasqal_query_get_variable ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable">rasqal_variable</a>* rasqal_query_get_variable (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int idx);</pre>
|
||
<p>
|
||
Get a variable in the sequence of variables to bind.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>idx</code></em> :</span></p></td>
|
||
<td> index into the sequence (0 or larger)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> a <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> pointer or NULL if out of the sequence range
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-verb"></a><h3>rasqal_query_get_verb ()</h3>
|
||
<pre class="programlisting"><a class="link" href="rasqal-section-query.html#rasqal-query-verb" title="enum rasqal_query_verb">rasqal_query_verb</a> rasqal_query_get_verb (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the query verb.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> the operating verb of the query of type rasqal_query_verb
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-wildcard"></a><h3>rasqal_query_get_wildcard ()</h3>
|
||
<pre class="programlisting">int rasqal_query_get_wildcard (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query);</pre>
|
||
<p>
|
||
Get the query verb is wildcard flag.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non-0 if the query verb was a wildcard (such as SELECT *)
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-has-variable"></a><h3>rasqal_query_has_variable ()</h3>
|
||
<pre class="programlisting">int rasqal_query_has_variable (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
unsigned char *name);</pre>
|
||
<p>
|
||
Find if the named variable is in the sequence of variables to bind.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</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> non-0 if the variable name was found.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-prepare"></a><h3>rasqal_query_prepare ()</h3>
|
||
<pre class="programlisting">int rasqal_query_prepare (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
unsigned char *query_string,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *base_uri);</pre>
|
||
<p>
|
||
Prepare a query - typically parse it.
|
||
</p>
|
||
<p>
|
||
Some query languages may require a base URI to resolve any
|
||
relative URIs in the query string. If this is not given,
|
||
the current directory in the filesystem is used as the base URI.
|
||
</p>
|
||
<p>
|
||
The query string may be NULL in which case it is not parsed
|
||
and the query parts may be created by API calls such as
|
||
rasqal_query_add_source etc.</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</code></em> :</span></p></td>
|
||
<td> the <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>query_string</code></em> :</span></p></td>
|
||
<td> the query string (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>base_uri</code></em> :</span></p></td>
|
||
<td> base URI of query string (optional)
|
||
</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="rasqal-query-print"></a><h3>rasqal_query_print ()</h3>
|
||
<pre class="programlisting">void rasqal_query_print (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
FILE *fh);</pre>
|
||
<p>
|
||
Print a query in a debug 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</code></em> :</span></p></td>
|
||
<td> the <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>fh</code></em> :</span></p></td>
|
||
<td> the <span class="type">FILE</span>* handle to print to.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-graph-pattern-visit"></a><h3>rasqal_query_graph_pattern_visit ()</h3>
|
||
<pre class="programlisting">void rasqal_query_graph_pattern_visit (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern-visit-fn" title="rasqal_graph_pattern_visit_fn ()">rasqal_graph_pattern_visit_fn</a> visit_fn,
|
||
void *data);</pre>
|
||
<p>
|
||
Visit all graph patterns in a query with a user function <em class="parameter"><code>visit_fn</code></em>.
|
||
</p>
|
||
<p>
|
||
See also <a class="link" href="rasqal-section-graph-pattern.html#rasqal-graph-pattern-visit" title="rasqal_graph_pattern_visit ()"><code class="function">rasqal_graph_pattern_visit()</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</code></em> :</span></p></td>
|
||
<td> query
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>visit_fn</code></em> :</span></p></td>
|
||
<td> user function to operate on
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
|
||
<td> user data to pass to function
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-default-generate-bnodeid-parameters"></a><h3>rasqal_query_set_default_generate_bnodeid_parameters ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_default_generate_bnodeid_parameters
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *rdf_query,
|
||
char *prefix,
|
||
int base);</pre>
|
||
<p>
|
||
Sets the parameters for the default algorithm used to generate
|
||
blank node IDs. The default algorithm uses both <em class="parameter"><code>prefix</code></em> and <em class="parameter"><code>base</code></em>
|
||
to generate a new identifier. The exact identifier generated is
|
||
not guaranteed to be a strict concatenation of <em class="parameter"><code>prefix</code></em> and <em class="parameter"><code>base</code></em>
|
||
but will use both parts.
|
||
</p>
|
||
<p>
|
||
For finer control of the generated identifiers, use
|
||
<code class="function">rasqal_set_default_generate_bnodeid_handler()</code>
|
||
</p>
|
||
<p>
|
||
If prefix is NULL, the default prefix is used (currently "bnodeid")
|
||
If base is less than 1, it is initialised to 1.</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>rdf_query</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>prefix</code></em> :</span></p></td>
|
||
<td> prefix string
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>base</code></em> :</span></p></td>
|
||
<td> integer base identifier
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-distinct"></a><h3>rasqal_query_set_distinct ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_distinct (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int distinct_mode);</pre>
|
||
<p>
|
||
Set the query distinct results mode.
|
||
</p>
|
||
<p>
|
||
The allowed <em class="parameter"><code>distinct_mode</code></em> values are:
|
||
0 if not given
|
||
1 if DISTINCT: ensure solutions are unique
|
||
2 if SPARQL REDUCED: permit elimination of some non-unique solutions</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>distinct_mode</code></em> :</span></p></td>
|
||
<td> distinct mode
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-explain"></a><h3>rasqal_query_set_explain ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_explain (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int is_explain);</pre>
|
||
<p>
|
||
Set the query explain results flag.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>is_explain</code></em> :</span></p></td>
|
||
<td> non-0 if explain
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-error-handler"></a><h3>rasqal_query_set_error_handler ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_error_handler (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-general.html#raptor-message-handler"
|
||
>raptor_message_handler</a> handler);</pre>
|
||
<p>
|
||
Set the query error handling function.
|
||
</p>
|
||
<p>
|
||
The function will receive callbacks when the query fails.</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</code></em> :</span></p></td>
|
||
<td> the query
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
||
<td> user data to pass to function
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td>
|
||
<td> pointer to the function
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-fatal-error-handler"></a><h3>rasqal_query_set_fatal_error_handler ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_fatal_error_handler
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-general.html#raptor-message-handler"
|
||
>raptor_message_handler</a> handler);</pre>
|
||
<p>
|
||
Set the query error handling function.
|
||
</p>
|
||
<p>
|
||
The function will receive callbacks when the query fails.</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</code></em> :</span></p></td>
|
||
<td> the query
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
||
<td> user data to pass to function
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td>
|
||
<td> pointer to the function
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-generate-bnodeid-handler"></a><h3>rasqal_query_set_generate_bnodeid_handler ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_generate_bnodeid_handler
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data,
|
||
rasqal_generate_bnodeid_handler handler);</pre>
|
||
<p>
|
||
Set the generate blank node ID handler function for the query.
|
||
</p>
|
||
<p>
|
||
Sets the function to generate blank node IDs for the query.
|
||
The handler is called with a pointer to the rasqal_query, the
|
||
<em class="parameter"><code>user_data</code></em> pointer and a user_bnodeid which is the value of
|
||
a user-provided blank node identifier (may be NULL).
|
||
It can either be returned directly as the generated value when present or
|
||
modified. The passed in value must be <code class="function">free()</code>d if it is not used.
|
||
</p>
|
||
<p>
|
||
If handler is NULL, the default method is used</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
||
<td> user data pointer for callback
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td>
|
||
<td> generate blank ID callback function
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-limit"></a><h3>rasqal_query_set_limit ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_limit (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int limit);</pre>
|
||
<p>
|
||
Set the query-specified limit on results.
|
||
</p>
|
||
<p>
|
||
This is the limit given in the query on the number of results allowed.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>limit</code></em> :</span></p></td>
|
||
<td> the limit on results, >=0 to set a limit, <0 to have no limit
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-offset"></a><h3>rasqal_query_set_offset ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_offset (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
int offset);</pre>
|
||
<p>
|
||
Set the query-specified offset on results.
|
||
</p>
|
||
<p>
|
||
This is the offset given in the query on the number of results allowed.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>offset</code></em> :</span></p></td>
|
||
<td> offset for results, >=0 to set an offset, <0 to have no offset
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-user-data"></a><h3>rasqal_query_set_user_data ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_user_data (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data);</pre>
|
||
<p>
|
||
Set the query user data.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
||
<td> some user data to associate with the query
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-variable"></a><h3>rasqal_query_set_variable ()</h3>
|
||
<pre class="programlisting">int rasqal_query_set_variable (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
unsigned char *name,
|
||
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *value);</pre>
|
||
<p>
|
||
Add a binding variable to the query.
|
||
</p>
|
||
<p>
|
||
See also rasqal_query_add_variable which adds a new binding variable
|
||
and must be called before this method is invoked.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> variable
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> value to set 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
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-warning-handler"></a><h3>rasqal_query_set_warning_handler ()</h3>
|
||
<pre class="programlisting">void rasqal_query_set_warning_handler (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
void *user_data,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-general.html#raptor-message-handler"
|
||
>raptor_message_handler</a> handler);</pre>
|
||
<p>
|
||
Set the query warning handling function.
|
||
</p>
|
||
<p>
|
||
The function will receive callbacks when the query gives a warning.</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</code></em> :</span></p></td>
|
||
<td> the query
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
||
<td> user data to pass to function
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>handler</code></em> :</span></p></td>
|
||
<td> pointer to the function
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-verb-as-string"></a><h3>rasqal_query_verb_as_string ()</h3>
|
||
<pre class="programlisting">const char* rasqal_query_verb_as_string (<a class="link" href="rasqal-section-query.html#rasqal-query-verb" title="enum rasqal_query_verb">rasqal_query_verb</a> verb);</pre>
|
||
<p>
|
||
Get a string for the query verb.</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>verb</code></em> :</span></p></td>
|
||
<td> the <a class="link" href="rasqal-section-query.html#rasqal-query-verb" title="enum rasqal_query_verb"><span class="type">rasqal_query_verb</span></a> verb of the query
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> pointer to a shared string label for the query verb
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-write"></a><h3>rasqal_query_write ()</h3>
|
||
<pre class="programlisting">int rasqal_query_write (<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-iostream.html#raptor-iostream"
|
||
>raptor_iostream</a> *iostr,
|
||
<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *format_uri,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
>raptor_uri</a> *base_uri);</pre>
|
||
<p>
|
||
Write a query to an iostream in a specified format.
|
||
</p>
|
||
<p>
|
||
The supported URIs for the format_uri are:
|
||
</p>
|
||
<p>
|
||
Default: SPARQL Query Language 2006-04-06
|
||
http://www.w3.org/TR/2006/CR-rdf-sparql-query-20060406/</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>query</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> pointer.
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>format_uri</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
><span class="type">raptor_uri</span></a> describing the format to write (or NULL for default)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>base_uri</code></em> :</span></p></td>
|
||
<td> <a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
|
||
><span class="type">raptor_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>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-iostream-write-escaped-counted-string"></a><h3>rasqal_query_iostream_write_escaped_counted_string ()</h3>
|
||
<pre class="programlisting">int rasqal_query_iostream_write_escaped_counted_string
|
||
(<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a
|
||
href="/usr/share/gtk-doc/html/raptor/raptor-section-iostream.html#raptor-iostream"
|
||
>raptor_iostream</a> *iostr,
|
||
unsigned char *string,
|
||
size_t len);</pre>
|
||
<p>
|
||
Write a string to an iostream in escaped form suitable for the query string.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> object
|
||
</td>
|
||
</tr>
|
||
<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 escaped string to
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
|
||
<td> string to escape
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
||
<td> Length of string to escape
|
||
</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="rasqal-query-escape-counted-string"></a><h3>rasqal_query_escape_counted_string ()</h3>
|
||
<pre class="programlisting">unsigned char* rasqal_query_escape_counted_string (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
unsigned char *string,
|
||
size_t len,
|
||
size_t *output_len_p);</pre>
|
||
<p>
|
||
Convert a string into an escaped form suitable for the query string.
|
||
</p>
|
||
<p>
|
||
The returned string must be freed by the caller with
|
||
<a class="link" href="rasqal-section-general.html#rasqal-free-memory" title="rasqal_free_memory ()"><code class="function">rasqal_free_memory()</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
|
||
<td> string to escape
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>len</code></em> :</span></p></td>
|
||
<td> Length of string to escape
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>output_len_p</code></em> :</span></p></td>
|
||
<td> Pointer to store length of output string (or NULL)
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> the escaped string or NULL on failure.
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-feature"></a><h3>rasqal_query_set_feature ()</h3>
|
||
<pre class="programlisting">int rasqal_query_set_feature (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature">rasqal_feature</a> feature,
|
||
int value);</pre>
|
||
<p>
|
||
Set various query features.
|
||
</p>
|
||
<p>
|
||
The allowed features are available via <a class="link" href="rasqal-section-general.html#rasqal-features-enumerate" title="rasqal_features_enumerate ()"><code class="function">rasqal_features_enumerate()</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>feature</code></em> :</span></p></td>
|
||
<td> feature to set from enumerated <a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature"><span class="type">rasqal_feature</span></a> values
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
||
<td> integer feature value
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non 0 on failure or if the feature is unknown
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-set-feature-string"></a><h3>rasqal_query_set_feature_string ()</h3>
|
||
<pre class="programlisting">int rasqal_query_set_feature_string (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature">rasqal_feature</a> feature,
|
||
unsigned char *value);</pre>
|
||
<p>
|
||
Set query features with string values.
|
||
</p>
|
||
<p>
|
||
The allowed features are available via <a class="link" href="rasqal-section-general.html#rasqal-features-enumerate" title="rasqal_features_enumerate ()"><code class="function">rasqal_features_enumerate()</code></a>.
|
||
If the feature type is integer, the value is interpreted as an integer.</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>feature</code></em> :</span></p></td>
|
||
<td> feature to set from enumerated <a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature"><span class="type">rasqal_feature</span></a> values
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
|
||
<td> feature value
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> non 0 on failure or if the feature is unknown
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-feature"></a><h3>rasqal_query_get_feature ()</h3>
|
||
<pre class="programlisting">int rasqal_query_get_feature (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature">rasqal_feature</a> feature);</pre>
|
||
<p>
|
||
Get various query features.
|
||
</p>
|
||
<p>
|
||
The allowed features are available via <a class="link" href="rasqal-section-general.html#rasqal-features-enumerate" title="rasqal_features_enumerate ()"><code class="function">rasqal_features_enumerate()</code></a>.
|
||
</p>
|
||
<p>
|
||
Note: no feature value is negative</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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>feature</code></em> :</span></p></td>
|
||
<td> feature to get value
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> feature value or < 0 for an illegal feature
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2" lang="en">
|
||
<a name="rasqal-query-get-feature-string"></a><h3>rasqal_query_get_feature_string ()</h3>
|
||
<pre class="programlisting">const unsigned char* rasqal_query_get_feature_string (<a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query">rasqal_query</a> *query,
|
||
<a class="link" href="rasqal-section-general.html#rasqal-feature" title="enum rasqal_feature">rasqal_feature</a> feature);</pre>
|
||
<p>
|
||
Get query features with string values.
|
||
</p>
|
||
<p>
|
||
The allowed features are available via <a class="link" href="rasqal-section-general.html#rasqal-features-enumerate" title="rasqal_features_enumerate ()"><code class="function">rasqal_features_enumerate()</code></a>.
|
||
If a string is returned, it 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</code></em> :</span></p></td>
|
||
<td> <a class="link" href="rasqal-section-query.html#rasqal-query" title="rasqal_query"><span class="type">rasqal_query</span></a> query object
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><em class="parameter"><code>feature</code></em> :</span></p></td>
|
||
<td> feature to get value
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
||
<td> feature value or NULL for an illegal feature or no value
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>
|
||
Generated by GTK-Doc V1.10</div>
|
||
</body>
|
||
</html>
|