Debian Codegraph @

docs/html/rasqal-section-literal.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>Literal</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
7 <link rel="home" href="index.html" title="Rasqal RDF Query Library Manual">
8 <link rel="up" href="reference-manual.html" title="Part I. Reference Manual">
9 <link rel="prev" href="rasqal-section-graph-pattern.html" title="Graph patterns">
10 <link rel="next" href="rasqal-section-prefix.html" title="Prefixes">
11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16 <tr valign="middle">
17 <td><a accesskey="p" href="rasqal-section-graph-pattern.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18 <td><a accesskey="u" href="reference-manual.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20 <th width="100%" align="center">Rasqal RDF Query Library Manual</th>
21 <td><a accesskey="n" href="rasqal-section-prefix.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22 </tr>
23 <tr><td colspan="5" class="shortcuts">
24 <a href="#rasqal-section-literal.synopsis" class="shortcut">Top</a>
25  | 
26 <a href="#rasqal-section-literal.description" class="shortcut">Description</a>
27 </td></tr>
28 </table>
29 <div class="refentry">
30 <a name="rasqal-section-literal"></a><div class="titlepage"></div>
31 <div class="refnamediv"><table width="100%"><tr>
32 <td valign="top">
33 <h2><span class="refentrytitle"><a name="rasqal-section-literal.top_of_page"></a>Literal</span></h2>
34 <p>Literal — RDF literals and RDF query-specific literals.</p>
35 </td>
36 <td valign="top" align="right"></td>
37 </tr></table></div>
38 <div class="refsynopsisdiv">
39 <a name="rasqal-section-literal.synopsis"></a><h2>Synopsis</h2>
40 <pre class="synopsis">typedef <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal">rasqal_literal</a>;
41 enum <a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type">rasqal_literal_type</a>;
42 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-typed-literal" title="rasqal_new_typed_literal ()">rasqal_new_typed_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
43 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
44 <em class="parameter"><code>const unsigned <span class="type">char</span> *string</code></em>);
45 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-boolean-literal" title="rasqal_new_boolean_literal ()">rasqal_new_boolean_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
46 <em class="parameter"><code><span class="type">int</span> value</code></em>);
47 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-datetime-literal-from-datetime" title="rasqal_new_datetime_literal_from_datetime ()">rasqal_new_datetime_literal_from_datetime</a>
48 (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
49 <em class="parameter"><code><a class="link" href="rasqal-section-xsd.html#rasqal-xsd-datetime" title="rasqal_xsd_datetime"><span class="type">rasqal_xsd_datetime</span></a> *dt</code></em>);
50 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-decimal-literal" title="rasqal_new_decimal_literal ()">rasqal_new_decimal_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
51 <em class="parameter"><code>const <span class="type">char</span> *string</code></em>);
52 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></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>
53 (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
54 <em class="parameter"><code>const <span class="type">char</span> *string</code></em>,
55 <em class="parameter"><code><a class="link" href="rasqal-section-xsd.html#rasqal-xsd-decimal" title="rasqal_xsd_decimal"><span class="type">rasqal_xsd_decimal</span></a> *decimal</code></em>);
56 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-double-literal" title="rasqal_new_double_literal ()">rasqal_new_double_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
57 <em class="parameter"><code><span class="type">double</span> d</code></em>);
58 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-float-literal" title="rasqal_new_float_literal ()">rasqal_new_float_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
59 <em class="parameter"><code><span class="type">float</span> f</code></em>);
60 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-floating-literal" title="rasqal_new_floating_literal ()">rasqal_new_floating_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
61 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
62 <em class="parameter"><code><span class="type">double</span> d</code></em>);
63 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-integer-literal" title="rasqal_new_integer_literal ()">rasqal_new_integer_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
64 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
65 <em class="parameter"><code><span class="type">int</span> integer</code></em>);
66 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-numeric-literal-from-long" title="rasqal_new_numeric_literal_from_long ()">rasqal_new_numeric_literal_from_long</a>
67 (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
68 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
69 <em class="parameter"><code>long <span class="type">value</span> Param3</code></em>);
70 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-pattern-literal" title="rasqal_new_pattern_literal ()">rasqal_new_pattern_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
71 <em class="parameter"><code>const <span class="type">char</span> *pattern</code></em>,
72 <em class="parameter"><code>const <span class="type">char</span> *flags</code></em>);
73 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-simple-literal" title="rasqal_new_simple_literal ()">rasqal_new_simple_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
74 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
75 <em class="parameter"><code>const <span class="type">char</span> *string</code></em>);
76 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-string-literal" title="rasqal_new_string_literal ()">rasqal_new_string_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
77 <em class="parameter"><code>const <span class="type">char</span> *string</code></em>,
78 <em class="parameter"><code>const <span class="type">char</span> *language</code></em>,
79 <em class="parameter"><code><span class="type">raptor_uri</span> *datatype</code></em>,
80 <em class="parameter"><code>const unsigned <span class="type">char</span> *datatype_qname</code></em>);
81 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-uri-literal" title="rasqal_new_uri_literal ()">rasqal_new_uri_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
82 <em class="parameter"><code><span class="type">raptor_uri</span> *uri</code></em>);
83 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-new-variable-literal" title="rasqal_new_variable_literal ()">rasqal_new_variable_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
84 <em class="parameter"><code><a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> *variable</code></em>);
85 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></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> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
86 <span class="returnvalue">void</span> <a class="link" href="rasqal-section-literal.html#rasqal-free-literal" title="rasqal_free_literal ()">rasqal_free_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
87 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-literal-as-node" title="rasqal_literal_as_node ()">rasqal_literal_as_node</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
88 const unsigned <span class="returnvalue">char</span> * <a class="link" href="rasqal-section-literal.html#rasqal-literal-as-counted-string" title="rasqal_literal_as_counted_string ()">rasqal_literal_as_counted_string</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>,
89 <em class="parameter"><code><span class="type">size_t</span> *len_p</code></em>,
90 <em class="parameter"><code><span class="type">int</span> flags</code></em>,
91 <em class="parameter"><code><span class="type">int</span> *error_p</code></em>);
92 const unsigned <span class="returnvalue">char</span> * <a class="link" href="rasqal-section-literal.html#rasqal-literal-as-string" title="rasqal_literal_as_string ()">rasqal_literal_as_string</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
93 const unsigned <span class="returnvalue">char</span> * <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> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>,
94 <em class="parameter"><code><span class="type">int</span> flags</code></em>,
95 <em class="parameter"><code><span class="type">int</span> *error_p</code></em>);
96 <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="returnvalue">rasqal_variable</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-literal-as-variable" title="rasqal_literal_as_variable ()">rasqal_literal_as_variable</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
97 <span class="returnvalue">int</span> <a class="link" href="rasqal-section-literal.html#rasqal-literal-compare" title="rasqal_literal_compare ()">rasqal_literal_compare</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l1</code></em>,
98 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l2</code></em>,
99 <em class="parameter"><code><span class="type">int</span> flags</code></em>,
100 <em class="parameter"><code><span class="type">int</span> *error_p</code></em>);
101 <span class="returnvalue">raptor_uri</span> * <a class="link" href="rasqal-section-literal.html#rasqal-literal-datatype" title="rasqal_literal_datatype ()">rasqal_literal_datatype</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
102 <span class="returnvalue">int</span> <a class="link" href="rasqal-section-literal.html#rasqal-literal-equals" title="rasqal_literal_equals ()">rasqal_literal_equals</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l1</code></em>,
103 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l2</code></em>);
104 <span class="returnvalue">char</span> * <a class="link" href="rasqal-section-literal.html#rasqal-literal-get-language" title="rasqal_literal_get_language ()">rasqal_literal_get_language</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
105 <a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="returnvalue">rasqal_literal_type</span></a> <a class="link" href="rasqal-section-literal.html#rasqal-literal-get-rdf-term-type" title="rasqal_literal_get_rdf_term_type ()">rasqal_literal_get_rdf_term_type</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
106 <a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="returnvalue">rasqal_literal_type</span></a> <a class="link" href="rasqal-section-literal.html#rasqal-literal-get-type" title="rasqal_literal_get_type ()">rasqal_literal_get_type</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
107 <span class="returnvalue">int</span> <a class="link" href="rasqal-section-literal.html#rasqal-literal-is-rdf-literal" title="rasqal_literal_is_rdf_literal ()">rasqal_literal_is_rdf_literal</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
108 <span class="returnvalue">int</span> <a class="link" href="rasqal-section-literal.html#rasqal-literal-print" title="rasqal_literal_print ()">rasqal_literal_print</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>,
109 <em class="parameter"><code><span class="type">FILE</span> *fh</code></em>);
110 <span class="returnvalue">void</span> <a class="link" href="rasqal-section-literal.html#rasqal-literal-print-type" title="rasqal_literal_print_type ()">rasqal_literal_print_type</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>,
111 <em class="parameter"><code><span class="type">FILE</span> *fh</code></em>);
112 const <span class="returnvalue">char</span> * <a class="link" href="rasqal-section-literal.html#rasqal-literal-type-label" title="rasqal_literal_type_label ()">rasqal_literal_type_label</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>);
113 <span class="returnvalue">int</span> <a class="link" href="rasqal-section-literal.html#rasqal-literal-same-term" title="rasqal_literal_same_term ()">rasqal_literal_same_term</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l1</code></em>,
114 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l2</code></em>);
115 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * <a class="link" href="rasqal-section-literal.html#rasqal-literal-value" title="rasqal_literal_value ()">rasqal_literal_value</a> (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);
116 </pre>
117 </div>
118 <div class="refsect1">
119 <a name="rasqal-section-literal.description"></a><h2>Description</h2>
120 <p>
121 A class for handling RDF terms (URI, blank nodes, strings, datatyped
122 literals) as well as those natively used in a query such as
123 boolean, double, floating, integer, regex pattern and variables.
124 </p>
125 </div>
126 <div class="refsect1">
127 <a name="rasqal-section-literal.details"></a><h2>Details</h2>
128 <div class="refsect2">
129 <a name="rasqal-literal"></a><h3>rasqal_literal</h3>
130 <pre class="programlisting">typedef struct rasqal_literal_s rasqal_literal;
131 </pre>
132 <p>
133 Rasqal literal class.
134 </p>
135 </div>
136 <hr>
137 <div class="refsect2">
138 <a name="rasqal-literal-type"></a><h3>enum rasqal_literal_type</h3>
139 <pre class="programlisting">typedef enum {
140 /* internal */
141 RASQAL_LITERAL_UNKNOWN,
142 RASQAL_LITERAL_BLANK,
143 RASQAL_LITERAL_URI,
144 RASQAL_LITERAL_STRING,
145 RASQAL_LITERAL_XSD_STRING,
146 RASQAL_LITERAL_BOOLEAN,
147 RASQAL_LITERAL_INTEGER,
148 RASQAL_LITERAL_FLOAT,
149 RASQAL_LITERAL_DOUBLE,
150 RASQAL_LITERAL_DECIMAL,
151 RASQAL_LITERAL_DATETIME,
152 /* internal */
153 RASQAL_LITERAL_FIRST_XSD = RASQAL_LITERAL_XSD_STRING,
154 /* internal */
155 RASQAL_LITERAL_LAST_XSD = RASQAL_LITERAL_DATETIME,
156 RASQAL_LITERAL_UDT,
157 RASQAL_LITERAL_PATTERN,
158 RASQAL_LITERAL_QNAME,
159 RASQAL_LITERAL_VARIABLE,
160 /* internal */
161 RASQAL_LITERAL_INTEGER_SUBTYPE,
162 RASQAL_LITERAL_DATE,
163 /* internal */
164 RASQAL_LITERAL_LAST = RASQAL_LITERAL_DATE
165 } rasqal_literal_type;
166 </pre>
167 <p>
168 Types of literal.
169 </p>
170 <p>
171 The order in the enumeration is significant as it encodes
172 the SPARQL term ordering conditions:
173 </p>
174 <p>
175 Blank Nodes &lt;&lt; IRIs &lt;&lt; RDF literals &lt;&lt; typed literals
176 </p>
177 <p>
178 which coresponds to in enum values
179 </p>
180 <p>
181 BLANK &lt;&lt; URI &lt;&lt; STRING &lt;&lt;
182 (BOOLEAN | INTEGER | DOUBLE | FLOAT | DECIMAL | DATETIME | XSD_STRING)
183 </p>
184 <p>
185 (RASQAL_LITERAL_FIRST_XSD ... RASQAL_LITERAL_LAST_XSD)
186 </p>
187 <p>
188 Not used (internal): PATTERN, QNAME, VARIABLE
189 </p>
190 <p>
191 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
192 <a class="link" href="rasqal-section-expression.html#RASQAL-COMPARE-XQUERY:CAPS"><code class="literal">RASQAL_COMPARE_XQUERY</code></a>
193 </p>
194 <div class="variablelist"><table border="0">
195 <col align="left" valign="top">
196 <tbody>
197 <tr>
198 <td><p><a name="RASQAL-LITERAL-UNKNOWN:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_UNKNOWN</code></span></p></td>
199 <td>Internal.
200 </td>
201 </tr>
202 <tr>
203 <td><p><a name="RASQAL-LITERAL-BLANK:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_BLANK</code></span></p></td>
204 <td>RDF blank node literal (SPARQL r:bNode)
205 </td>
206 </tr>
207 <tr>
208 <td><p><a name="RASQAL-LITERAL-URI:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_URI</code></span></p></td>
209 <td>RDF URI Literal (SPARQL r:URI)
210 </td>
211 </tr>
212 <tr>
213 <td><p><a name="RASQAL-LITERAL-STRING:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_STRING</code></span></p></td>
214 <td>RDF Plain Literal - no datatype (SPARQL r:Literal)
215 </td>
216 </tr>
217 <tr>
218 <td><p><a name="RASQAL-LITERAL-XSD-STRING:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_XSD_STRING</code></span></p></td>
219 <td>String xsd:string
220 </td>
221 </tr>
222 <tr>
223 <td><p><a name="RASQAL-LITERAL-BOOLEAN:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_BOOLEAN</code></span></p></td>
224 <td>Boolean literal xsd:boolean.
225 </td>
226 </tr>
227 <tr>
228 <td><p><a name="RASQAL-LITERAL-INTEGER:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_INTEGER</code></span></p></td>
229 <td>Integer literal xsd:integer.
230 </td>
231 </tr>
232 <tr>
233 <td><p><a name="RASQAL-LITERAL-FLOAT:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_FLOAT</code></span></p></td>
234 <td>Floating point literal xsd:float.
235 </td>
236 </tr>
237 <tr>
238 <td><p><a name="RASQAL-LITERAL-DOUBLE:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_DOUBLE</code></span></p></td>
239 <td>Double floating point literal xsd:double.
240 </td>
241 </tr>
242 <tr>
243 <td><p><a name="RASQAL-LITERAL-DECIMAL:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_DECIMAL</code></span></p></td>
244 <td>Decimal integer xsd:decimal.
245 </td>
246 </tr>
247 <tr>
248 <td><p><a name="RASQAL-LITERAL-DATETIME:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_DATETIME</code></span></p></td>
249 <td>Date/Time literal xsd:dateTime.
250 </td>
251 </tr>
252 <tr>
253 <td><p><a name="RASQAL-LITERAL-FIRST-XSD:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_FIRST_XSD</code></span></p></td>
254 <td>Internal.
255 </td>
256 </tr>
257 <tr>
258 <td><p><a name="RASQAL-LITERAL-LAST-XSD:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_LAST_XSD</code></span></p></td>
259 <td>Internal.
260 </td>
261 </tr>
262 <tr>
263 <td><p><a name="RASQAL-LITERAL-UDT:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_UDT</code></span></p></td>
264 <td>User defined typed literal with unknown datatype URI
265 </td>
266 </tr>
267 <tr>
268 <td><p><a name="RASQAL-LITERAL-PATTERN:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_PATTERN</code></span></p></td>
269 <td>Pattern literal for a regex.
270 </td>
271 </tr>
272 <tr>
273 <td><p><a name="RASQAL-LITERAL-QNAME:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_QNAME</code></span></p></td>
274 <td>XML Qname literal.
275 </td>
276 </tr>
277 <tr>
278 <td><p><a name="RASQAL-LITERAL-VARIABLE:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_VARIABLE</code></span></p></td>
279 <td>Variable literal.
280 </td>
281 </tr>
282 <tr>
283 <td><p><a name="RASQAL-LITERAL-INTEGER-SUBTYPE:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_INTEGER_SUBTYPE</code></span></p></td>
284 <td>Internal.
285 </td>
286 </tr>
287 <tr>
288 <td><p><a name="RASQAL-LITERAL-DATE:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_DATE</code></span></p></td>
289 <td>Date literal xsd:date.
290 </td>
291 </tr>
292 <tr>
293 <td><p><a name="RASQAL-LITERAL-LAST:CAPS"></a><span class="term"><code class="literal">RASQAL_LITERAL_LAST</code></span></p></td>
294 <td>Internal.
295 </td>
296 </tr>
297 </tbody>
298 </table></div>
299 </div>
300 <hr>
301 <div class="refsect2">
302 <a name="rasqal-new-typed-literal"></a><h3>rasqal_new_typed_literal ()</h3>
303 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_typed_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
304 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
305 <em class="parameter"><code>const unsigned <span class="type">char</span> *string</code></em>);</pre>
306 <p>
307 Constructor - Create a new Rasqal integer literal from a string
308 </p>
309 <p>
310 The integer decimal number is turned into a rasqal integer literal
311 and given a datatype of xsd:integer
312 </p>
313 <div class="variablelist"><table border="0">
314 <col align="left" valign="top">
315 <tbody>
316 <tr>
317 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
318 <td>rasqal world object</td>
319 </tr>
320 <tr>
321 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
322 <td>Type of literal such as RASQAL_LITERAL_INTEGER or RASQAL_LITERAL_BOOLEAN</td>
323 </tr>
324 <tr>
325 <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
326 <td>lexical form - ownership not taken</td>
327 </tr>
328 <tr>
329 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
330 <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>
331 </tr>
332 </tbody>
333 </table></div>
334 </div>
335 <hr>
336 <div class="refsect2">
337 <a name="rasqal-new-boolean-literal"></a><h3>rasqal_new_boolean_literal ()</h3>
338 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_boolean_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
339 <em class="parameter"><code><span class="type">int</span> value</code></em>);</pre>
340 <p>
341 Constructor - Create a new Rasqal boolean literal.
342 </p>
343 <div class="variablelist"><table border="0">
344 <col align="left" valign="top">
345 <tbody>
346 <tr>
347 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
348 <td>rasqal world object</td>
349 </tr>
350 <tr>
351 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
352 <td>non-0 for true, 0 for false</td>
353 </tr>
354 <tr>
355 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
356 <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>
357 </tr>
358 </tbody>
359 </table></div>
360 </div>
361 <hr>
362 <div class="refsect2">
363 <a name="rasqal-new-datetime-literal-from-datetime"></a><h3>rasqal_new_datetime_literal_from_datetime ()</h3>
364 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_datetime_literal_from_datetime
365 (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
366 <em class="parameter"><code><a class="link" href="rasqal-section-xsd.html#rasqal-xsd-datetime" title="rasqal_xsd_datetime"><span class="type">rasqal_xsd_datetime</span></a> *dt</code></em>);</pre>
367 <p>
368 Constructor - Create a new Rasqal datetime literal from an existing datetime.
369 </p>
370 <p>
371 Takes ownership of <em class="parameter"><code>dt</code></em>
372 </p>
373 <div class="variablelist"><table border="0">
374 <col align="left" valign="top">
375 <tbody>
376 <tr>
377 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
378 <td>rasqal world object</td>
379 </tr>
380 <tr>
381 <td><p><span class="term"><em class="parameter"><code>dt</code></em> :</span></p></td>
382 <td>rasqal XSD Datetime</td>
383 </tr>
384 <tr>
385 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
386 <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>
387 </tr>
388 </tbody>
389 </table></div>
390 </div>
391 <hr>
392 <div class="refsect2">
393 <a name="rasqal-new-decimal-literal"></a><h3>rasqal_new_decimal_literal ()</h3>
394 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_decimal_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
395 <em class="parameter"><code>const <span class="type">char</span> *string</code></em>);</pre>
396 <p>
397 Constructor - Create a new Rasqal decimal literal.
398 </p>
399 <div class="variablelist"><table border="0">
400 <col align="left" valign="top">
401 <tbody>
402 <tr>
403 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
404 <td>rasqal world object</td>
405 </tr>
406 <tr>
407 <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
408 <td>decimal literal</td>
409 </tr>
410 <tr>
411 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
412 <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>
413 </tr>
414 </tbody>
415 </table></div>
416 </div>
417 <hr>
418 <div class="refsect2">
419 <a name="rasqal-new-decimal-literal-from-decimal"></a><h3>rasqal_new_decimal_literal_from_decimal ()</h3>
420 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_decimal_literal_from_decimal
421 (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
422 <em class="parameter"><code>const <span class="type">char</span> *string</code></em>,
423 <em class="parameter"><code><a class="link" href="rasqal-section-xsd.html#rasqal-xsd-decimal" title="rasqal_xsd_decimal"><span class="type">rasqal_xsd_decimal</span></a> *decimal</code></em>);</pre>
424 <p>
425 Constructor - Create a new Rasqal decimal literal.
426 </p>
427 <div class="variablelist"><table border="0">
428 <col align="left" valign="top">
429 <tbody>
430 <tr>
431 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
432 <td>rasqal world object</td>
433 </tr>
434 <tr>
435 <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
436 <td>decimal literal string</td>
437 </tr>
438 <tr>
439 <td><p><span class="term"><em class="parameter"><code>decimal</code></em> :</span></p></td>
440 <td>rasqal XSD Decimal</td>
441 </tr>
442 <tr>
443 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
444 <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>
445 </tr>
446 </tbody>
447 </table></div>
448 </div>
449 <hr>
450 <div class="refsect2">
451 <a name="rasqal-new-double-literal"></a><h3>rasqal_new_double_literal ()</h3>
452 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_double_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
453 <em class="parameter"><code><span class="type">double</span> d</code></em>);</pre>
454 <p>
455 Constructor - Create a new Rasqal double literal.
456 </p>
457 <div class="variablelist"><table border="0">
458 <col align="left" valign="top">
459 <tbody>
460 <tr>
461 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
462 <td>rasqal world object</td>
463 </tr>
464 <tr>
465 <td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
466 <td>double literal</td>
467 </tr>
468 <tr>
469 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
470 <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>
471 </tr>
472 </tbody>
473 </table></div>
474 </div>
475 <hr>
476 <div class="refsect2">
477 <a name="rasqal-new-float-literal"></a><h3>rasqal_new_float_literal ()</h3>
478 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_float_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
479 <em class="parameter"><code><span class="type">float</span> f</code></em>);</pre>
480 <p>
481 Constructor - Create a new Rasqal float literal.
482 </p>
483 <p>
484 <em class="parameter"><code>Deprecated</code></em>: Use <a class="link" href="rasqal-section-literal.html#rasqal-new-floating-literal" title="rasqal_new_floating_literal ()"><code class="function">rasqal_new_floating_literal()</code></a> with type
485 <a class="link" href="rasqal-section-literal.html#RASQAL-LITERAL-FLOAT:CAPS"><span class="type">RASQAL_LITERAL_FLOAT</span></a> and double value.
486 </p>
487 <div class="variablelist"><table border="0">
488 <col align="left" valign="top">
489 <tbody>
490 <tr>
491 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
492 <td>rasqal world object</td>
493 </tr>
494 <tr>
495 <td><p><span class="term"><em class="parameter"><code>f</code></em> :</span></p></td>
496 <td>float literal</td>
497 </tr>
498 <tr>
499 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
500 <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>
501 </tr>
502 </tbody>
503 </table></div>
504 </div>
505 <hr>
506 <div class="refsect2">
507 <a name="rasqal-new-floating-literal"></a><h3>rasqal_new_floating_literal ()</h3>
508 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_floating_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
509 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
510 <em class="parameter"><code><span class="type">double</span> d</code></em>);</pre>
511 <p>
512 Constructor - Create a new Rasqal float literal from a double.
513 </p>
514 <div class="variablelist"><table border="0">
515 <col align="left" valign="top">
516 <tbody>
517 <tr>
518 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
519 <td>rasqal world object</td>
520 </tr>
521 <tr>
522 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
523 <td>type - <a class="link" href="rasqal-section-literal.html#RASQAL-LITERAL-FLOAT:CAPS"><span class="type">RASQAL_LITERAL_FLOAT</span></a> or <a class="link" href="rasqal-section-literal.html#RASQAL-LITERAL-DOUBLE:CAPS"><span class="type">RASQAL_LITERAL_DOUBLE</span></a>
524 </td>
525 </tr>
526 <tr>
527 <td><p><span class="term"><em class="parameter"><code>d</code></em> :</span></p></td>
528 <td>floating literal (double)</td>
529 </tr>
530 <tr>
531 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
532 <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>
533 </tr>
534 </tbody>
535 </table></div>
536 </div>
537 <hr>
538 <div class="refsect2">
539 <a name="rasqal-new-integer-literal"></a><h3>rasqal_new_integer_literal ()</h3>
540 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_integer_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
541 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
542 <em class="parameter"><code><span class="type">int</span> integer</code></em>);</pre>
543 <p>
544 Constructor - Create a new Rasqal integer literal.
545 </p>
546 <p>
547 The integer decimal number is turned into a rasqal integer literal
548 and given a datatype of xsd:integer
549 </p>
550 <div class="variablelist"><table border="0">
551 <col align="left" valign="top">
552 <tbody>
553 <tr>
554 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
555 <td>rasqal world object</td>
556 </tr>
557 <tr>
558 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
559 <td>Type of literal such as RASQAL_LITERAL_INTEGER or RASQAL_LITERAL_BOOLEAN</td>
560 </tr>
561 <tr>
562 <td><p><span class="term"><em class="parameter"><code>integer</code></em> :</span></p></td>
563 <td>int value</td>
564 </tr>
565 <tr>
566 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
567 <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>
568 </tr>
569 </tbody>
570 </table></div>
571 </div>
572 <hr>
573 <div class="refsect2">
574 <a name="rasqal-new-numeric-literal-from-long"></a><h3>rasqal_new_numeric_literal_from_long ()</h3>
575 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_numeric_literal_from_long
576 (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
577 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
578 <em class="parameter"><code>long <span class="type">value</span> Param3</code></em>);</pre>
579 <p>
580 Constructor - Create a new Rasqal numeric literal from a long.
581 </p>
582 <p>
583 The value is turned into a rasqal integer or decimal literal and
584 given a datatype of xsd:integer
585 </p>
586 <div class="variablelist"><table border="0">
587 <col align="left" valign="top">
588 <tbody>
589 <tr>
590 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
591 <td>rasqal world object</td>
592 </tr>
593 <tr>
594 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
595 <td>Type of literal such as RASQAL_LITERAL_INTEGER or RASQAL_LITERAL_BOOLEAN</td>
596 </tr>
597 <tr>
598 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
599 <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>
600 </tr>
601 </tbody>
602 </table></div>
603 </div>
604 <hr>
605 <div class="refsect2">
606 <a name="rasqal-new-pattern-literal"></a><h3>rasqal_new_pattern_literal ()</h3>
607 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_pattern_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
608 <em class="parameter"><code>const <span class="type">char</span> *pattern</code></em>,
609 <em class="parameter"><code>const <span class="type">char</span> *flags</code></em>);</pre>
610 <p>
611 Constructor - Create a new Rasqal pattern literal.
612 </p>
613 <p>
614 The pattern and flags are input parameters and are stored in the
615 literal, not copied. They are freed also on failure.
616 The set of flags recognised depends on the regex library and the query
617 language.
618 </p>
619 <div class="variablelist"><table border="0">
620 <col align="left" valign="top">
621 <tbody>
622 <tr>
623 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
624 <td>rasqal world object</td>
625 </tr>
626 <tr>
627 <td><p><span class="term"><em class="parameter"><code>pattern</code></em> :</span></p></td>
628 <td>regex pattern</td>
629 </tr>
630 <tr>
631 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
632 <td>regex flags</td>
633 </tr>
634 <tr>
635 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
636 <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>
637 </tr>
638 </tbody>
639 </table></div>
640 </div>
641 <hr>
642 <div class="refsect2">
643 <a name="rasqal-new-simple-literal"></a><h3>rasqal_new_simple_literal ()</h3>
644 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_simple_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
645 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>,
646 <em class="parameter"><code>const <span class="type">char</span> *string</code></em>);</pre>
647 <p>
648 Constructor - Create a new Rasqal simple literal.
649 </p>
650 <p>
651 The string is an input parameter and is stored in the
652 literal, not copied. It is freed also on failure.
653 </p>
654 <div class="variablelist"><table border="0">
655 <col align="left" valign="top">
656 <tbody>
657 <tr>
658 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
659 <td>rasqal world object</td>
660 </tr>
661 <tr>
662 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
663 <td>RASQAL_LITERAL_BLANK or RASQAL_LITERAL_BLANK_QNAME</td>
664 </tr>
665 <tr>
666 <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
667 <td>the UTF-8 string value to store</td>
668 </tr>
669 <tr>
670 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
671 <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>
672 </tr>
673 </tbody>
674 </table></div>
675 </div>
676 <hr>
677 <div class="refsect2">
678 <a name="rasqal-new-string-literal"></a><h3>rasqal_new_string_literal ()</h3>
679 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_string_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
680 <em class="parameter"><code>const <span class="type">char</span> *string</code></em>,
681 <em class="parameter"><code>const <span class="type">char</span> *language</code></em>,
682 <em class="parameter"><code><span class="type">raptor_uri</span> *datatype</code></em>,
683 <em class="parameter"><code>const unsigned <span class="type">char</span> *datatype_qname</code></em>);</pre>
684 <p>
685 Constructor - Create a new Rasqal string literal.
686 </p>
687 <p>
688 All parameters are input parameters and if present are stored in
689 the literal, not copied. They are freed also on failure.
690 </p>
691 <p>
692 The datatype and datatype_qname parameters are alternatives; the
693 qname is a datatype that cannot be resolved till later since the
694 prefixes have not yet been declared or checked.
695 </p>
696 <p>
697 If the string literal is datatyped and of certain types recognised
698 it may be converted to a different literal type.
699 </p>
700 <div class="variablelist"><table border="0">
701 <col align="left" valign="top">
702 <tbody>
703 <tr>
704 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
705 <td>rasqal world object</td>
706 </tr>
707 <tr>
708 <td><p><span class="term"><em class="parameter"><code>string</code></em> :</span></p></td>
709 <td>UTF-8 string lexical form</td>
710 </tr>
711 <tr>
712 <td><p><span class="term"><em class="parameter"><code>language</code></em> :</span></p></td>
713 <td>RDF language (xml:lang) (or NULL)</td>
714 </tr>
715 <tr>
716 <td><p><span class="term"><em class="parameter"><code>datatype</code></em> :</span></p></td>
717 <td>datatype URI (or NULL for plain literal)</td>
718 </tr>
719 <tr>
720 <td><p><span class="term"><em class="parameter"><code>datatype_qname</code></em> :</span></p></td>
721 <td>datatype qname string (or NULL for plain literal)</td>
722 </tr>
723 <tr>
724 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
725 <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>
726 </tr>
727 </tbody>
728 </table></div>
729 </div>
730 <hr>
731 <div class="refsect2">
732 <a name="rasqal-new-uri-literal"></a><h3>rasqal_new_uri_literal ()</h3>
733 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_uri_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
734 <em class="parameter"><code><span class="type">raptor_uri</span> *uri</code></em>);</pre>
735 <p>
736 Constructor - Create a new Rasqal URI literal from a raptor URI.
737 </p>
738 <p>
739 The uri is an input parameter and is stored in the literal, not copied.
740 The uri is freed also on failure.
741 </p>
742 <div class="variablelist"><table border="0">
743 <col align="left" valign="top">
744 <tbody>
745 <tr>
746 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
747 <td>rasqal world object</td>
748 </tr>
749 <tr>
750 <td><p><span class="term"><em class="parameter"><code>uri</code></em> :</span></p></td>
751 <td>
752 <span class="type">raptor_uri</span> uri</td>
753 </tr>
754 <tr>
755 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
756 <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>
757 </tr>
758 </tbody>
759 </table></div>
760 </div>
761 <hr>
762 <div class="refsect2">
763 <a name="rasqal-new-variable-literal"></a><h3>rasqal_new_variable_literal ()</h3>
764 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_variable_literal (<em class="parameter"><code><a class="link" href="rasqal-section-general.html#rasqal-world" title="rasqal_world"><span class="type">rasqal_world</span></a> *world</code></em>,
765 <em class="parameter"><code><a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> *variable</code></em>);</pre>
766 <p>
767 Constructor - Create a new Rasqal variable literal.
768 </p>
769 <p>
770 variable is an input parameter and stored in the literal, not copied.
771 </p>
772 <div class="variablelist"><table border="0">
773 <col align="left" valign="top">
774 <tbody>
775 <tr>
776 <td><p><span class="term"><em class="parameter"><code>world</code></em> :</span></p></td>
777 <td>rasqal_world object</td>
778 </tr>
779 <tr>
780 <td><p><span class="term"><em class="parameter"><code>variable</code></em> :</span></p></td>
781 <td>
782 <a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="type">rasqal_variable</span></a> to use</td>
783 </tr>
784 <tr>
785 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
786 <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>
787 </tr>
788 </tbody>
789 </table></div>
790 </div>
791 <hr>
792 <div class="refsect2">
793 <a name="rasqal-new-literal-from-literal"></a><h3>rasqal_new_literal_from_literal ()</h3>
794 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_new_literal_from_literal (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
795 <p>
796 Copy Constructor - create a new rasqal_literal object from an existing rasqal_literal object.
797 </p>
798 <div class="variablelist"><table border="0">
799 <col align="left" valign="top">
800 <tbody>
801 <tr>
802 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
803 <td>
804 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object to copy or NULL</td>
805 </tr>
806 <tr>
807 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
808 <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 if <em class="parameter"><code>l</code></em> was NULL.</td>
809 </tr>
810 </tbody>
811 </table></div>
812 </div>
813 <hr>
814 <div class="refsect2">
815 <a name="rasqal-free-literal"></a><h3>rasqal_free_literal ()</h3>
816 <pre class="programlisting"><span class="returnvalue">void</span> rasqal_free_literal (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
817 <p>
818 Destructor - destroy an rasqal_literal object.
819 </p>
820 <div class="variablelist"><table border="0">
821 <col align="left" valign="top">
822 <tbody><tr>
823 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
824 <td>
825 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
826 </tr></tbody>
827 </table></div>
828 </div>
829 <hr>
830 <div class="refsect2">
831 <a name="rasqal-literal-as-node"></a><h3>rasqal_literal_as_node ()</h3>
832 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_literal_as_node (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
833 <p>
834 Turn a literal into a new RDF string, URI or blank literal.
835 </p>
836 <div class="variablelist"><table border="0">
837 <col align="left" valign="top">
838 <tbody>
839 <tr>
840 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
841 <td>
842 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
843 </tr>
844 <tr>
845 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
846 <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 or if the literal was an unbound variable.</td>
847 </tr>
848 </tbody>
849 </table></div>
850 </div>
851 <hr>
852 <div class="refsect2">
853 <a name="rasqal-literal-as-counted-string"></a><h3>rasqal_literal_as_counted_string ()</h3>
854 <pre class="programlisting">const unsigned <span class="returnvalue">char</span> * rasqal_literal_as_counted_string (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>,
855 <em class="parameter"><code><span class="type">size_t</span> *len_p</code></em>,
856 <em class="parameter"><code><span class="type">int</span> flags</code></em>,
857 <em class="parameter"><code><span class="type">int</span> *error_p</code></em>);</pre>
858 <p>
859 Return a counted string format of a literal according to flags.
860 </p>
861 <p>
862 flag bits affects conversion:
863 RASQAL_COMPARE_XQUERY: use XQuery conversion rules
864 </p>
865 <p>
866 If <em class="parameter"><code>error</code></em> is not NULL, *error is set to non-0 on error
867 </p>
868 <div class="variablelist"><table border="0">
869 <col align="left" valign="top">
870 <tbody>
871 <tr>
872 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
873 <td>
874 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
875 </tr>
876 <tr>
877 <td><p><span class="term"><em class="parameter"><code>len_p</code></em> :</span></p></td>
878 <td>pointer to store length of string (or NULL)</td>
879 </tr>
880 <tr>
881 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
882 <td>comparison flags</td>
883 </tr>
884 <tr>
885 <td><p><span class="term"><em class="parameter"><code>error_p</code></em> :</span></p></td>
886 <td>pointer to error</td>
887 </tr>
888 <tr>
889 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
890 <td>pointer to a shared string format of the literal.</td>
891 </tr>
892 </tbody>
893 </table></div>
894 </div>
895 <hr>
896 <div class="refsect2">
897 <a name="rasqal-literal-as-string"></a><h3>rasqal_literal_as_string ()</h3>
898 <pre class="programlisting">const unsigned <span class="returnvalue">char</span> * rasqal_literal_as_string (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
899 <p>
900 Return the string format of a literal.
901 </p>
902 <div class="variablelist"><table border="0">
903 <col align="left" valign="top">
904 <tbody>
905 <tr>
906 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
907 <td>
908 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
909 </tr>
910 <tr>
911 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
912 <td>pointer to a shared string format of the literal.</td>
913 </tr>
914 </tbody>
915 </table></div>
916 </div>
917 <hr>
918 <div class="refsect2">
919 <a name="rasqal-literal-as-string-flags"></a><h3>rasqal_literal_as_string_flags ()</h3>
920 <pre class="programlisting">const unsigned <span class="returnvalue">char</span> * rasqal_literal_as_string_flags (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>,
921 <em class="parameter"><code><span class="type">int</span> flags</code></em>,
922 <em class="parameter"><code><span class="type">int</span> *error_p</code></em>);</pre>
923 <p>
924 Return the string format of a literal according to flags.
925 </p>
926 <p>
927 flag bits affects conversion:
928 RASQAL_COMPARE_XQUERY: use XQuery conversion rules
929 </p>
930 <p>
931 If <em class="parameter"><code>error</code></em> is not NULL, *error is set to non-0 on error
932 </p>
933 <div class="variablelist"><table border="0">
934 <col align="left" valign="top">
935 <tbody>
936 <tr>
937 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
938 <td>
939 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
940 </tr>
941 <tr>
942 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
943 <td>comparison flags</td>
944 </tr>
945 <tr>
946 <td><p><span class="term"><em class="parameter"><code>error_p</code></em> :</span></p></td>
947 <td>pointer to error</td>
948 </tr>
949 <tr>
950 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
951 <td>pointer to a shared string format of the literal.</td>
952 </tr>
953 </tbody>
954 </table></div>
955 </div>
956 <hr>
957 <div class="refsect2">
958 <a name="rasqal-literal-as-variable"></a><h3>rasqal_literal_as_variable ()</h3>
959 <pre class="programlisting"><a class="link" href="rasqal-section-variable.html#rasqal-variable" title="rasqal_variable"><span class="returnvalue">rasqal_variable</span></a> * rasqal_literal_as_variable (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
960 <p>
961 Get the variable inside a literal.
962 </p>
963 <div class="variablelist"><table border="0">
964 <col align="left" valign="top">
965 <tbody>
966 <tr>
967 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
968 <td>
969 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
970 </tr>
971 <tr>
972 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
973 <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>
974 </tr>
975 </tbody>
976 </table></div>
977 </div>
978 <hr>
979 <div class="refsect2">
980 <a name="rasqal-literal-compare"></a><h3>rasqal_literal_compare ()</h3>
981 <pre class="programlisting"><span class="returnvalue">int</span> rasqal_literal_compare (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l1</code></em>,
982 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l2</code></em>,
983 <em class="parameter"><code><span class="type">int</span> flags</code></em>,
984 <em class="parameter"><code><span class="type">int</span> *error_p</code></em>);</pre>
985 <p>
986 Compare two literals with type promotion.
987 </p>
988 <p>
989 The two literals are compared across their range. If the types
990 are not the same, they are promoted. If one is a double or float, the
991 other is promoted to double, otherwise for integers, otherwise
992 to strings (all literals have a string value).
993 </p>
994 <p>
995 The comparison returned is as for strcmp, first before second
996 returns &lt;0. equal returns 0, and first after second returns &gt;0.
997 For URIs, the string value is used for the comparsion.
998 </p>
999 <p>
1000 flag bits affects comparisons:
1001 RASQAL_COMPARE_NOCASE: use case independent string comparisons
1002 RASQAL_COMPARE_XQUERY: use XQuery comparison and type promotion rules
1003 RASQAL_COMPARE_RDF: use RDF term comparison
1004 RASQAL_COMPARE_URI: allow comparison of URIs (typically for SPARQL ORDER)
1005 </p>
1006 <p>
1007 If <em class="parameter"><code>error</code></em> is not NULL, *error is set to non-0 on error
1008 </p>
1009 <div class="variablelist"><table border="0">
1010 <col align="left" valign="top">
1011 <tbody>
1012 <tr>
1013 <td><p><span class="term"><em class="parameter"><code>l1</code></em> :</span></p></td>
1014 <td>
1015 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> first literal</td>
1016 </tr>
1017 <tr>
1018 <td><p><span class="term"><em class="parameter"><code>l2</code></em> :</span></p></td>
1019 <td>
1020 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> second literal</td>
1021 </tr>
1022 <tr>
1023 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
1024 <td>comparison flags</td>
1025 </tr>
1026 <tr>
1027 <td><p><span class="term"><em class="parameter"><code>error_p</code></em> :</span></p></td>
1028 <td>pointer to error</td>
1029 </tr>
1030 <tr>
1031 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1032 <td>&lt;0, 0, or &gt;0 as described above.</td>
1033 </tr>
1034 </tbody>
1035 </table></div>
1036 </div>
1037 <hr>
1038 <div class="refsect2">
1039 <a name="rasqal-literal-datatype"></a><h3>rasqal_literal_datatype ()</h3>
1040 <pre class="programlisting"><span class="returnvalue">raptor_uri</span> * rasqal_literal_datatype (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
1041 <p>
1042 Get the datatype URI of a literal
1043 </p>
1044 <div class="variablelist"><table border="0">
1045 <col align="left" valign="top">
1046 <tbody>
1047 <tr>
1048 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
1049 <td>
1050 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
1051 </tr>
1052 <tr>
1053 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1054 <td>shared pointer to <span class="type">raptor_uri</span> of datatype or NULL on failure or no value</td>
1055 </tr>
1056 </tbody>
1057 </table></div>
1058 </div>
1059 <hr>
1060 <div class="refsect2">
1061 <a name="rasqal-literal-equals"></a><h3>rasqal_literal_equals ()</h3>
1062 <pre class="programlisting"><span class="returnvalue">int</span> rasqal_literal_equals (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l1</code></em>,
1063 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l2</code></em>);</pre>
1064 <p>
1065 Compare two literals with no type promotion.
1066 </p>
1067 <p>
1068 If the l2 data literal value is a boolean, it will match
1069 the string "true" or "false" in the first literal l1.
1070 </p>
1071 <div class="variablelist"><table border="0">
1072 <col align="left" valign="top">
1073 <tbody>
1074 <tr>
1075 <td><p><span class="term"><em class="parameter"><code>l1</code></em> :</span></p></td>
1076 <td>
1077 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> literal</td>
1078 </tr>
1079 <tr>
1080 <td><p><span class="term"><em class="parameter"><code>l2</code></em> :</span></p></td>
1081 <td>
1082 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> data literal</td>
1083 </tr>
1084 <tr>
1085 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1086 <td>non-0 if equal</td>
1087 </tr>
1088 </tbody>
1089 </table></div>
1090 </div>
1091 <hr>
1092 <div class="refsect2">
1093 <a name="rasqal-literal-get-language"></a><h3>rasqal_literal_get_language ()</h3>
1094 <pre class="programlisting"><span class="returnvalue">char</span> * rasqal_literal_get_language (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
1095 <p>
1096 Get the language of a literal (if set)
1097 </p>
1098 <div class="variablelist"><table border="0">
1099 <col align="left" valign="top">
1100 <tbody>
1101 <tr>
1102 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
1103 <td>literal</td>
1104 </tr>
1105 <tr>
1106 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1107 <td>the literal language or NULL</td>
1108 </tr>
1109 </tbody>
1110 </table></div>
1111 </div>
1112 <hr>
1113 <div class="refsect2">
1114 <a name="rasqal-literal-get-rdf-term-type"></a><h3>rasqal_literal_get_rdf_term_type ()</h3>
1115 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="returnvalue">rasqal_literal_type</span></a> rasqal_literal_get_rdf_term_type (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
1116 <p>
1117 Get the RDF term type of a literal
1118 </p>
1119 <p>
1120 An RDF term can be one of three choices:
1121 1. URI: RASQAL_LITERAL_URI
1122 2. literal: RASQAL_LITERAL_STRING
1123 3. blank node: RASQAL_LITERAL_BLANK
1124 </p>
1125 <p>
1126 Other non RDF-term cases include: NULL pointer, invalid literal,
1127 unknown type, a variable or other special cases (such as XML QName
1128 or Regex pattern) which all turn into RASQAL_LITERAL_UNKNOWN
1129 </p>
1130 <div class="variablelist"><table border="0">
1131 <col align="left" valign="top">
1132 <tbody>
1133 <tr>
1134 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
1135 <td>literal</td>
1136 </tr>
1137 <tr>
1138 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1139 <td>type or RASQAL_LITERAL_UNKNOWN if cannot be an RDF term</td>
1140 </tr>
1141 </tbody>
1142 </table></div>
1143 </div>
1144 <hr>
1145 <div class="refsect2">
1146 <a name="rasqal-literal-get-type"></a><h3>rasqal_literal_get_type ()</h3>
1147 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="returnvalue">rasqal_literal_type</span></a> rasqal_literal_get_type (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
1148 <p>
1149 Get the type of a literal
1150 </p>
1151 <div class="variablelist"><table border="0">
1152 <col align="left" valign="top">
1153 <tbody>
1154 <tr>
1155 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
1156 <td>literal</td>
1157 </tr>
1158 <tr>
1159 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1160 <td>the rasqal literal type or RASQAL_LITERAL_UNKNOWN if l is NULL</td>
1161 </tr>
1162 </tbody>
1163 </table></div>
1164 </div>
1165 <hr>
1166 <div class="refsect2">
1167 <a name="rasqal-literal-is-rdf-literal"></a><h3>rasqal_literal_is_rdf_literal ()</h3>
1168 <pre class="programlisting"><span class="returnvalue">int</span> rasqal_literal_is_rdf_literal (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
1169 <p>
1170 Check if a literal is any RDF term literal - plain or typed literal
1171 </p>
1172 <div class="variablelist"><table border="0">
1173 <col align="left" valign="top">
1174 <tbody>
1175 <tr>
1176 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
1177 <td>
1178 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> literal</td>
1179 </tr>
1180 <tr>
1181 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1182 <td>non-0 if the value is an RDF term literal</td>
1183 </tr>
1184 </tbody>
1185 </table></div>
1186 </div>
1187 <hr>
1188 <div class="refsect2">
1189 <a name="rasqal-literal-print"></a><h3>rasqal_literal_print ()</h3>
1190 <pre class="programlisting"><span class="returnvalue">int</span> rasqal_literal_print (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>,
1191 <em class="parameter"><code><span class="type">FILE</span> *fh</code></em>);</pre>
1192 <p>
1193 Print a Rasqal literal in a debug format.
1194 </p>
1195 <p>
1196 The print debug format may change in any release.
1197 </p>
1198 <div class="variablelist"><table border="0">
1199 <col align="left" valign="top">
1200 <tbody>
1201 <tr>
1202 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
1203 <td>the <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
1204 </tr>
1205 <tr>
1206 <td><p><span class="term"><em class="parameter"><code>fh</code></em> :</span></p></td>
1207 <td>the FILE handle to print to</td>
1208 </tr>
1209 <tr>
1210 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1211 <td>non-0 on failure</td>
1212 </tr>
1213 </tbody>
1214 </table></div>
1215 </div>
1216 <hr>
1217 <div class="refsect2">
1218 <a name="rasqal-literal-print-type"></a><h3>rasqal_literal_print_type ()</h3>
1219 <pre class="programlisting"><span class="returnvalue">void</span> rasqal_literal_print_type (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>,
1220 <em class="parameter"><code><span class="type">FILE</span> *fh</code></em>);</pre>
1221 <p>
1222 Print a string form for a rasqal literal type.
1223 </p>
1224 <div class="variablelist"><table border="0">
1225 <col align="left" valign="top">
1226 <tbody>
1227 <tr>
1228 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
1229 <td>the <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
1230 </tr>
1231 <tr>
1232 <td><p><span class="term"><em class="parameter"><code>fh</code></em> :</span></p></td>
1233 <td>the FILE* handle to print to</td>
1234 </tr>
1235 </tbody>
1236 </table></div>
1237 </div>
1238 <hr>
1239 <div class="refsect2">
1240 <a name="rasqal-literal-type-label"></a><h3>rasqal_literal_type_label ()</h3>
1241 <pre class="programlisting">const <span class="returnvalue">char</span> * rasqal_literal_type_label (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> type</code></em>);</pre>
1242 <p>
1243 Get a label for the rasqal literal type
1244 </p>
1245 <div class="variablelist"><table border="0">
1246 <col align="left" valign="top">
1247 <tbody>
1248 <tr>
1249 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
1250 <td>the <a class="link" href="rasqal-section-literal.html#rasqal-literal-type" title="enum rasqal_literal_type"><span class="type">rasqal_literal_type</span></a> object</td>
1251 </tr>
1252 <tr>
1253 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1254 <td>the label (shared string) or NULL if type is out of
1255 range or unknown</td>
1256 </tr>
1257 </tbody>
1258 </table></div>
1259 </div>
1260 <hr>
1261 <div class="refsect2">
1262 <a name="rasqal-literal-same-term"></a><h3>rasqal_literal_same_term ()</h3>
1263 <pre class="programlisting"><span class="returnvalue">int</span> rasqal_literal_same_term (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l1</code></em>,
1264 <em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l2</code></em>);</pre>
1265 <p>
1266 Check if literals are same term (URI, literal, blank)
1267 </p>
1268 <div class="variablelist"><table border="0">
1269 <col align="left" valign="top">
1270 <tbody>
1271 <tr>
1272 <td><p><span class="term"><em class="parameter"><code>l1</code></em> :</span></p></td>
1273 <td>
1274 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> literal</td>
1275 </tr>
1276 <tr>
1277 <td><p><span class="term"><em class="parameter"><code>l2</code></em> :</span></p></td>
1278 <td>
1279 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> data literal</td>
1280 </tr>
1281 <tr>
1282 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1283 <td>non-0 if same</td>
1284 </tr>
1285 </tbody>
1286 </table></div>
1287 </div>
1288 <hr>
1289 <div class="refsect2">
1290 <a name="rasqal-literal-value"></a><h3>rasqal_literal_value ()</h3>
1291 <pre class="programlisting"><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="returnvalue">rasqal_literal</span></a> * rasqal_literal_value (<em class="parameter"><code><a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> *l</code></em>);</pre>
1292 <p>
1293 Get the literal value looking up any variables needed
1294 </p>
1295 <div class="variablelist"><table border="0">
1296 <col align="left" valign="top">
1297 <tbody>
1298 <tr>
1299 <td><p><span class="term"><em class="parameter"><code>l</code></em> :</span></p></td>
1300 <td>
1301 <a class="link" href="rasqal-section-literal.html#rasqal-literal" title="rasqal_literal"><span class="type">rasqal_literal</span></a> object</td>
1302 </tr>
1303 <tr>
1304 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1305 <td>literal value or NULL if has no value</td>
1306 </tr>
1307 </tbody>
1308 </table></div>
1309 </div>
1310 </div>
1311 </div>
1312 <div class="footer">
1313 <hr>
1314 Generated by GTK-Doc V1.18</div>
1315 </body>
1316 </html>