Autres/audacity
1
0
Fork 0
mirror of https://github.com/cookiengineer/audacity synced 2025-05-11 06:31:07 +02:00
Code Issues Releases Wiki Activity
audacity/lib-src/redland/rasqal/docs/html/rasqal-section-literal.html
ra 58caf78a86 Move library tree where it belongs
2010-01-24 09:19:39 +00:00

1109 lines
52 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Literal</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-graph-pattern.html" title="Graph patterns">
<link rel="next" href="rasqal-section-prefix.html" title="Prefixes">
<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-graph-pattern.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-prefix.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-literal.synopsis" class="shortcut">Top</a>
 | 
<a href="#rasqal-section-literal.description" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="rasqal-section-literal"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="rasqal-section-literal.top_of_page"></a>Literal</span></h2>
<p>Literal — RDF literals and RDF query-specific literals.</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="rasqal-section-literal.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
typedef <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>;
enum <a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type">rasqal_literal_type</a>;
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-typed-literal" title="rasqal_new_typed_literal ()">rasqal_new_typed_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type">rasqal_literal_type</a> type,
unsigned char *string);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-boolean-literal" title="rasqal_new_boolean_literal ()">rasqal_new_boolean_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
int value);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-decimal-literal" title="rasqal_new_decimal_literal ()">rasqal_new_decimal_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
unsigned char *string);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-decimal-literal-from-decimal" title="rasqal_new_decimal_literal_from_decimal ()">rasqal_new_decimal_literal_from_decimal</a>
(<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
unsigned char *string,
<a class="link" href="rasqal-section-xsd.html#rasqal-xsd-decimal" title="rasqal_xsd_decimal">rasqal_xsd_decimal</a> *decimal);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-double-literal" title="rasqal_new_double_literal ()">rasqal_new_double_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
double d);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-float-literal" title="rasqal_new_float_literal ()">rasqal_new_float_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
float f);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-integer-literal" title="rasqal_new_integer_literal ()">rasqal_new_integer_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type">rasqal_literal_type</a> type,
int integer);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-pattern-literal" title="rasqal_new_pattern_literal ()">rasqal_new_pattern_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
unsigned char *pattern,
const char *flags);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-simple-literal" title="rasqal_new_simple_literal ()">rasqal_new_simple_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type">rasqal_literal_type</a> type,
unsigned char *string);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-string-literal" title="rasqal_new_string_literal ()">rasqal_new_string_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
unsigned char *string,
const char *language,
<a
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
>raptor_uri</a> *datatype,
unsigned char *datatype_qname);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-uri-literal" title="rasqal_new_uri_literal ()">rasqal_new_uri_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
>raptor_uri</a> *uri);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-variable-literal" title="rasqal_new_variable_literal ()">rasqal_new_variable_literal</a> (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable">rasqal_variable</a> *variable);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-new-literal-from-literal" title="rasqal_new_literal_from_literal ()">rasqal_new_literal_from_literal</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);
void <a class="link" href="rasqal-section-literal.html#rasqal-free-literal" title="rasqal_free_literal ()">rasqal_free_literal</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-literal-as-node" title="rasqal_literal_as_node ()">rasqal_literal_as_node</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);
const unsigned char* <a class="link" href="rasqal-section-literal.html#rasqal-literal-as-string" title="rasqal_literal_as_string ()">rasqal_literal_as_string</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);
const unsigned char* <a class="link" href="rasqal-section-literal.html#rasqal-literal-as-string-flags" title="rasqal_literal_as_string_flags ()">rasqal_literal_as_string_flags</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l,
int flags,
int *error);
<a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable">rasqal_variable</a>* <a class="link" href="rasqal-section-literal.html#rasqal-literal-as-variable" title="rasqal_literal_as_variable ()">rasqal_literal_as_variable</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);
int <a class="link" href="rasqal-section-literal.html#rasqal-literal-compare" title="rasqal_literal_compare ()">rasqal_literal_compare</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l1,
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l2,
int flags,
int *error);
<a
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
>raptor_uri</a>* <a class="link" href="rasqal-section-literal.html#rasqal-literal-datatype" title="rasqal_literal_datatype ()">rasqal_literal_datatype</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);
int <a class="link" href="rasqal-section-literal.html#rasqal-literal-equals" title="rasqal_literal_equals ()">rasqal_literal_equals</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l1,
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l2);
void <a class="link" href="rasqal-section-literal.html#rasqal-literal-print" title="rasqal_literal_print ()">rasqal_literal_print</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l,
FILE *fh);
void <a class="link" href="rasqal-section-literal.html#rasqal-literal-print-type" title="rasqal_literal_print_type ()">rasqal_literal_print_type</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l,
FILE *fh);
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* <a class="link" href="rasqal-section-literal.html#rasqal-literal-value" title="rasqal_literal_value ()">rasqal_literal_value</a> (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="rasqal-section-literal.description"></a><h2>Description</h2>
<p>
A class for handling RDF terms (URI, blank nodes, strings, datatyped
literals) as well as those natively used in a query such as
boolean, double, floating, integer, regex pattern and variables.
</p>
</div>
<div class="refsect1" lang="en">
<a name="rasqal-section-literal.details"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="rasqal-literal"></a><h3>rasqal_literal</h3>
<pre class="programlisting">typedef struct rasqal_literal_s rasqal_literal;
</pre>
<p>
Rasqal literal class.</p>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-type"></a><h3>enum rasqal_literal_type</h3>
<pre class="programlisting">typedef enum {
/* internal */
RASQAL_LITERAL_UNKNOWN,
RASQAL_LITERAL_BLANK,
RASQAL_LITERAL_URI,
RASQAL_LITERAL_STRING,
RASQAL_LITERAL_BOOLEAN,
RASQAL_LITERAL_INTEGER,
RASQAL_LITERAL_DOUBLE,
RASQAL_LITERAL_FLOAT,
RASQAL_LITERAL_DECIMAL,
RASQAL_LITERAL_DATETIME,
/* internal */
RASQAL_LITERAL_FIRST_XSD = RASQAL_LITERAL_STRING,
/* internal */
RASQAL_LITERAL_LAST_XSD = RASQAL_LITERAL_DATETIME,
RASQAL_LITERAL_PATTERN,
RASQAL_LITERAL_QNAME,
RASQAL_LITERAL_VARIABLE,
/* internal */
RASQAL_LITERAL_LAST= RASQAL_LITERAL_VARIABLE
} rasqal_literal_type;
</pre>
<p>
Types of literal.
</p>
<p>
The order in the enumeration is significant as it encodes
the SPARQL term ordering conditions:
</p>
<p>
Blank Nodes &lt;&lt; IRIs &lt;&lt; RDF literals &lt;&lt; typed literals
</p>
<p>
which coresponds to in enum values
</p>
<p>
BLANK &lt;&lt; URI &lt;&lt; STRING &lt;&lt;
(BOOLEAN | INTEGER | DOUBLE | FLOAT | DECIMAL | DATETIME)
</p>
<p>
(RASQAL_LITERAL_FIRST_XSD ... RASQAL_LITERAL_LAST_XSD)
</p>
<p>
Not used (internal): PATTERN, QNAME, VARIABLE
</p>
<p>
See <a class="link" href="rasqal-section-literal.html#rasqal-literal-compare" title="rasqal_literal_compare ()"><code class="function">rasqal_literal_compare()</code></a> when used with flags
<a class="link" href="rasqal-section-expression.html#RASQAL-COMPARE-XQUERY:CAPS"><code class="literal">RASQAL_COMPARE_XQUERY</code></a></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><a name="RASQAL-LITERAL-UNKNOWN:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_UNKNOWN</code></span></p></td>
<td> Internal.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-BLANK:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_BLANK</code></span></p></td>
<td> RDF blank node literal (SPARQL r:bNode)
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-URI:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_URI</code></span></p></td>
<td> RDF URI Literal (SPARQL r:URI)
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-STRING:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_STRING</code></span></p></td>
<td> RDF Literal / xsd:string (SPARQL r:Literal)
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-BOOLEAN:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_BOOLEAN</code></span></p></td>
<td> Boolean literal xsd:boolean.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-INTEGER:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_INTEGER</code></span></p></td>
<td> Integer literal xsd:integer.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-DOUBLE:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_DOUBLE</code></span></p></td>
<td> Double floating point literal xsd:double.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-FLOAT:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_FLOAT</code></span></p></td>
<td> Floating point literal xsd:float.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-DECIMAL:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_DECIMAL</code></span></p></td>
<td> Decimal integer xsd:decimal.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-DATETIME:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_DATETIME</code></span></p></td>
<td> Date/Time literal xsd:dateTime.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-FIRST-XSD:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_FIRST_XSD</code></span></p></td>
<td> Internal.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-LAST-XSD:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_LAST_XSD</code></span></p></td>
<td> Internal.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-PATTERN:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_PATTERN</code></span></p></td>
<td> Pattern literal for a regex.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-QNAME:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_QNAME</code></span></p></td>
<td> XML Qname literal.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-VARIABLE:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_VARIABLE</code></span></p></td>
<td> Variable literal.
</td>
</tr>
<tr>
<td><p><a name="RASQAL-LITERAL-LAST:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_LAST</code></span></p></td>
<td> Internal.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-typed-literal"></a><h3>rasqal_new_typed_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_typed_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type">rasqal_literal_type</a> type,
unsigned char *string);</pre>
<p>
Constructor - Create a new Rasqal integer literal from a string
</p>
<p>
The integer decimal number is turned into a rasqal integer literal
and given a datatype of xsd: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>world</code></em> :</span></p></td>
<td> rasqal world object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
<td> Type of literal such as RASQAL_LITERAL_INTEGER or RASQAL_LITERAL_BOOLEAN
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
<td> lexical form - ownership not taken
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-boolean-literal"></a><h3>rasqal_new_boolean_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_boolean_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
int value);</pre>
<p>
Constructor - Create a new Rasqal boolean literal.</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>value</code></em> :</span></p></td>
<td> non-0 for true, 0 for false
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-decimal-literal"></a><h3>rasqal_new_decimal_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_decimal_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
unsigned char *string);</pre>
<p>
Constructor - Create a new Rasqal decimal literal.</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>string</code></em> :</span></p></td>
<td> decimal literal
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-decimal-literal-from-decimal"></a><h3>rasqal_new_decimal_literal_from_decimal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_decimal_literal_from_decimal
(<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
unsigned char *string,
<a class="link" href="rasqal-section-xsd.html#rasqal-xsd-decimal" title="rasqal_xsd_decimal">rasqal_xsd_decimal</a> *decimal);</pre>
<p>
Constructor - Create a new Rasqal decimal literal.</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>string</code></em> :</span></p></td>
<td> decimal literal string
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>decimal</code></em> :</span></p></td>
<td> rasqal XSD Decimal
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-double-literal"></a><h3>rasqal_new_double_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_double_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
double d);</pre>
<p>
Constructor - Create a new Rasqal double literal.</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>d</code></em> :</span></p></td>
<td> double literal
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-float-literal"></a><h3>rasqal_new_float_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_float_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
float f);</pre>
<p>
Constructor - Create a new Rasqal float literal.</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>f</code></em> :</span></p></td>
<td> float literal
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-integer-literal"></a><h3>rasqal_new_integer_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_integer_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type">rasqal_literal_type</a> type,
int integer);</pre>
<p>
Constructor - Create a new Rasqal integer literal.
</p>
<p>
The integer decimal number is turned into a rasqal integer literal
and given a datatype of xsd: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>world</code></em> :</span></p></td>
<td> rasqal world object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
<td> Type of literal such as RASQAL_LITERAL_INTEGER or RASQAL_LITERAL_BOOLEAN
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>integer</code></em> :</span></p></td>
<td> int value
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-pattern-literal"></a><h3>rasqal_new_pattern_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_pattern_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
unsigned char *pattern,
const char *flags);</pre>
<p>
Constructor - Create a new Rasqal pattern literal.
</p>
<p>
The pattern and flags are input parameters and are stored in the
literal, not copied. They are freed also on failure.
The set of flags recognised depends on the regex engine and 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>world</code></em> :</span></p></td>
<td> rasqal world object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
<td> regex pattern
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td> regex flags
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-simple-literal"></a><h3>rasqal_new_simple_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_simple_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type">rasqal_literal_type</a> type,
unsigned char *string);</pre>
<p>
Constructor - Create a new Rasqal simple literal.
</p>
<p>
The string is an input parameter and is stored in the
literal, not copied. It is freed also on failure.</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>type</code></em> :</span></p></td>
<td> RASQAL_LITERAL_BLANK or RASQAL_LITERAL_BLANK_QNAME
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
<td> the UTF-8 string value to store
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-string-literal"></a><h3>rasqal_new_string_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_string_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
unsigned char *string,
const char *language,
<a
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
>raptor_uri</a> *datatype,
unsigned char *datatype_qname);</pre>
<p>
Constructor - Create a new Rasqal string literal.
</p>
<p>
All parameters are input parameters and if present are stored in
the literal, not copied. They are freed also on failure.
</p>
<p>
The datatype and datatype_qname parameters are alternatives; the
qname is a datatype that cannot be resolved till later since the
prefixes have not yet been declared or checked.
</p>
<p>
If the string literal is datatyped and of certain types recognised
it may be converted to a different literal type by
<code class="function">rasqal_literal_string_to_native()</code></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>string</code></em> :</span></p></td>
<td> UTF-8 string lexical form
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
<td> RDF language (xml:lang) (or NULL)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>datatype</code></em> :</span></p></td>
<td> datatype URI (or NULL for plain literal)
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>datatype_qname</code></em> :</span></p></td>
<td> datatype qname string (or NULL for plain literal)
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-uri-literal"></a><h3>rasqal_new_uri_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_uri_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
>raptor_uri</a> *uri);</pre>
<p>
Constructor - Create a new Rasqal URI literal from a raptor URI.
</p>
<p>
The uri is an input parameter and is stored in the literal, not copied.
The uri is freed also on failure.</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>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> uri
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-variable-literal"></a><h3>rasqal_new_variable_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_variable_literal (<a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world">rasqal_world</a> *world,
<a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable">rasqal_variable</a> *variable);</pre>
<p>
Constructor - Create a new Rasqal variable literal.
</p>
<p>
variable is an input parameter and stored in the literal, not copied.</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>variable</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> to use
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> New <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-new-literal-from-literal"></a><h3>rasqal_new_literal_from_literal ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_new_literal_from_literal (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);</pre>
<p>
Copy Constructor - create a new rasqal_literal object from an existing rasqal_literal 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>l</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> object to copy
</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-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object or NULL
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-free-literal"></a><h3>rasqal_free_literal ()</h3>
<pre class="programlisting">void rasqal_free_literal (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);</pre>
<p>
Destructor - destroy an rasqal_literal 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>l</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> object
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-as-node"></a><h3>rasqal_literal_as_node ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_literal_as_node (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);</pre>
<p>
Turn a literal into a new RDF string, URI or blank literal.</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>l</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> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the new <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> or NULL on failure
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-as-string"></a><h3>rasqal_literal_as_string ()</h3>
<pre class="programlisting">const unsigned char* rasqal_literal_as_string (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);</pre>
<p>
Return the string format of a literal.</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>l</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> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> pointer to a shared string format of the literal.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-as-string-flags"></a><h3>rasqal_literal_as_string_flags ()</h3>
<pre class="programlisting">const unsigned char* rasqal_literal_as_string_flags (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l,
int flags,
int *error);</pre>
<p>
Return the string format of a literal according to flags.
</p>
<p>
flag bits affects conversion:
RASQAL_COMPARE_XQUERY: use XQuery conversion rules
</p>
<p>
If <em class="parameter"><code>error</code></em> is not NULL, *error is set to non-0 on error</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>l</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> object
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td> comparison flags
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td> pointer to error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> pointer to a shared string format of the literal.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-as-variable"></a><h3>rasqal_literal_as_variable ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable">rasqal_variable</a>* rasqal_literal_as_variable (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);</pre>
<p>
Get the variable inside a literal.</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>l</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> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> the <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> or NULL if the literal is not a variable
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-compare"></a><h3>rasqal_literal_compare ()</h3>
<pre class="programlisting">int rasqal_literal_compare (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l1,
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l2,
int flags,
int *error);</pre>
<p>
Compare two literals with type promotion.
</p>
<p>
The two literals are compared across their range. If the types
are not the same, they are promoted. If one is a double or float, the
other is promoted to double, otherwise for integers, otherwise
to strings (all literals have a string value).
</p>
<p>
The comparison returned is as for strcmp, first before second
returns &lt;0. equal returns 0, and first after second returns &gt;0.
For URIs, the string value is used for the comparsion.
</p>
<p>
flag bits affects comparisons:
RASQAL_COMPARE_NOCASE: use case independent string comparisons
RASQAL_COMPARE_XQUERY: use XQuery comparison and type promotion rules
RASQAL_COMPARE_RDF: use RDF term comparison
RASQAL_COMPARE_URI: allow comparison of URIs (typically for SPARQL ORDER)
</p>
<p>
If <em class="parameter"><code>error</code></em> is not NULL, *error is set to non-0 on error</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>l1</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> first literal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>l2</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> second literal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td> comparison flags
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td> pointer to error
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> &lt;0, 0, or &gt;0 as described above.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-datatype"></a><h3>rasqal_literal_datatype ()</h3>
<pre class="programlisting"><a
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
>raptor_uri</a>* rasqal_literal_datatype (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);</pre>
<p>
Get the datatype URI of a literal</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>l</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> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> shared pointer to <a
href="/usr/share/gtk-doc/html/raptor/raptor-section-uri.html#raptor-uri"
><span class="type">raptor_uri</span></a> of datatype or NULL on failure or no value
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-equals"></a><h3>rasqal_literal_equals ()</h3>
<pre class="programlisting">int rasqal_literal_equals (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l1,
<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l2);</pre>
<p>
Compare two literals with no type promotion.
</p>
<p>
If the l2 data literal value is a boolean, it will match
the string "true" or "false" in the first literal l1.</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>l1</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> literal
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>l2</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> data literal
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> non-0 if equal
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="rasqal-literal-print"></a><h3>rasqal_literal_print ()</h3>
<pre class="programlisting">void rasqal_literal_print (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l,
FILE *fh);</pre>
<p>
Print a Rasqal literal in a debug format.
</p>
<p>
The print debug format may change in any release.</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>l</code></em> :</span></p></td>
<td> the <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</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-literal-print-type"></a><h3>rasqal_literal_print_type ()</h3>
<pre class="programlisting">void rasqal_literal_print_type (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l,
FILE *fh);</pre>
<p>
Print a string form for a rasqal literal type.</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>l</code></em> :</span></p></td>
<td> the <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</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-literal-value"></a><h3>rasqal_literal_value ()</h3>
<pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>* rasqal_literal_value (<a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a> *l);</pre>
<p>
Get the literal value looking up any variables needed</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>l</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> object
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> literal value or NULL if has no value
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.10</div>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink