171 lines
15 KiB
HTML
171 lines
15 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
|
|
<title>XQilla XQC API Documentation</title>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css">
|
|
<link href="tabs.css" rel="stylesheet" type="text/css">
|
|
</head><body>
|
|
<a style="float:right;" href="http://sourceforge.net/projects/xqilla"><img src="http://sflogo.sourceforge.net/sflogo.php?group_id=152021&type=2" border="0" alt="SourceForge.net Logo" /></a>
|
|
<!-- Generated by Doxygen 1.6.1 -->
|
|
<div class="navigation" id="top">
|
|
<div class="tabs">
|
|
<ul>
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="pages.html"><span>Related Pages</span></a></li>
|
|
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
<li><a href="examples.html"><span>Examples</span></a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="tabs">
|
|
<ul>
|
|
<li><a href="annotated.html"><span>Class List</span></a></li>
|
|
<li><a href="functions.html"><span>Class Members</span></a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="contents">
|
|
<h1>XQC_Expression_s Struct Reference</h1><!-- doxytag: class="XQC_Expression_s" -->
|
|
<p>The <a class="el" href="xqc_8h.html#a707b112e9370ee771b38ea01574df8ff">XQC_Expression</a> struct represents a prepared query, and allows the user to execute that query any number of times.
|
|
<a href="#_details">More...</a></p>
|
|
|
|
<p><code>#include <<a class="el" href="xqc_8h_source.html">xqc.h</a>></code></p>
|
|
|
|
<p><a href="structXQC__Expression__s-members.html">List of all members.</a></p>
|
|
<table border="0" cellpadding="0" cellspacing="0">
|
|
<tr><td colspan="2"><h2>Public Attributes</h2></td></tr>
|
|
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3f">XQC_Error</a>(* </td><td class="memItemRight" valign="bottom"><a class="el" href="structXQC__Expression__s.html#a04be56651df9f3f47aecd99a0b0ad66e">create_context</a> )(const <a class="el" href="structXQC__Expression__s.html">XQC_Expression</a> *expression, <a class="el" href="structXQC__DynamicContext__s.html">XQC_DynamicContext</a> **context)</td></tr>
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a dynamic context suitable for use in the <a class="el" href="structXQC__Expression__s.html#a3181579fa2677d43c29efd31a649726c" title="Executes the query represented by the XQC_Expression object using the values in the...">execute()</a> function. <a href="#a04be56651df9f3f47aecd99a0b0ad66e"></a><br/></td></tr>
|
|
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3f">XQC_Error</a>(* </td><td class="memItemRight" valign="bottom"><a class="el" href="structXQC__Expression__s.html#a3181579fa2677d43c29efd31a649726c">execute</a> )(const <a class="el" href="structXQC__Expression__s.html">XQC_Expression</a> *expression, const <a class="el" href="structXQC__DynamicContext__s.html">XQC_DynamicContext</a> *context, <a class="el" href="structXQC__Sequence__s.html">XQC_Sequence</a> **sequence)</td></tr>
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Executes the query represented by the XQC_Expression object using the values in the <a class="el" href="xqc_8h.html#acf4c0769616363086377cb527484d33e">XQC_DynamicContext</a> if provided. <a href="#a3181579fa2677d43c29efd31a649726c"></a><br/></td></tr>
|
|
<tr><td class="memItemLeft" align="right" valign="top">void *(* </td><td class="memItemRight" valign="bottom"><a class="el" href="structXQC__Expression__s.html#acc0d2caee9f7a61e68c57d18c1d4bd66">get_interface</a> )(const <a class="el" href="structXQC__Expression__s.html">XQC_Expression</a> *expression, const char *name)</td></tr>
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Called to retrieve an implementation specific interface. <a href="#acc0d2caee9f7a61e68c57d18c1d4bd66"></a><br/></td></tr>
|
|
<tr><td class="memItemLeft" align="right" valign="top">void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="structXQC__Expression__s.html#a6aa28a94f0ff6732c26f131bbe4d44a9">free</a> )(<a class="el" href="structXQC__Expression__s.html">XQC_Expression</a> *expression)</td></tr>
|
|
<tr><td class="mdescLeft"> </td><td class="mdescRight">Called to free the resources associated with the XQC_Expression. <a href="#a6aa28a94f0ff6732c26f131bbe4d44a9"></a><br/></td></tr>
|
|
</table>
|
|
<hr/><a name="_details"></a><h2>Detailed Description</h2>
|
|
<p>The <a class="el" href="xqc_8h.html#a707b112e9370ee771b38ea01574df8ff">XQC_Expression</a> struct represents a prepared query, and allows the user to execute that query any number of times. </p>
|
|
<p>An <a class="el" href="xqc_8h.html#a707b112e9370ee771b38ea01574df8ff">XQC_Expression</a> object is thread-safe and can be used by multiple threads of execution at the same time.</p>
|
|
<p><a class="el" href="xqc_8h.html#a707b112e9370ee771b38ea01574df8ff">XQC_Expression</a> objects are created by calling the <a class="el" href="structXQC__Implementation__s.html#a4f82aa0b0e5c675f95f6c78b3bf76216" title="Prepares a query from a UTF-8 string, returning an XQC_Expression object.">XQC_Implementation::prepare()</a>, <a class="el" href="structXQC__Implementation__s.html#a1ad25fbbed1449a0923e3ea274c81336" title="Prepares a query from a FILE pointer, returning an XQC_Expression object.">XQC_Implementation::prepare_file()</a> and <a class="el" href="structXQC__Implementation__s.html#a5f43c181bbab51770a3c1c8943060745" title="Prepares a query from an XQC_InputStream, returning an XQC_Expression object.">XQC_Implementation::prepare_stream()</a> functions. Once created, the user is responsible for freeing the object by calling the <a class="el" href="structXQC__Expression__s.html#a6aa28a94f0ff6732c26f131bbe4d44a9" title="Called to free the resources associated with the XQC_Expression.">free()</a> function. The <a class="el" href="xqc_8h.html#a707b112e9370ee771b38ea01574df8ff">XQC_Expression</a> object should be freed before the <a class="el" href="xqc_8h.html#a3d46d69abb6d7b408bb8cd8c02ce66fb">XQC_Implementation</a> object that created it.</p>
|
|
<dl><dt><b>Examples: </b></dt><dd>
|
|
<p><a class="el" href="xqc-basic_8c-example.html#_a1">xqc-basic.c</a>, and <a class="el" href="xqc-context-item_8c-example.html#_a1">xqc-context-item.c</a>.</p>
|
|
</dd>
|
|
</dl><hr/><h2>Member Data Documentation</h2>
|
|
<a class="anchor" id="a04be56651df9f3f47aecd99a0b0ad66e"></a><!-- doxytag: member="XQC_Expression_s::create_context" ref="a04be56651df9f3f47aecd99a0b0ad66e" args=")(const XQC_Expression *expression, XQC_DynamicContext **context)" -->
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3f">XQC_Error</a>(* <a class="el" href="structXQC__Expression__s.html#a04be56651df9f3f47aecd99a0b0ad66e">XQC_Expression_s::create_context</a>)(const <a class="el" href="structXQC__Expression__s.html">XQC_Expression</a> *expression, <a class="el" href="structXQC__DynamicContext__s.html">XQC_DynamicContext</a> **context)</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="memdoc">
|
|
|
|
<p>Creates a dynamic context suitable for use in the <a class="el" href="structXQC__Expression__s.html#a3181579fa2677d43c29efd31a649726c" title="Executes the query represented by the XQC_Expression object using the values in the...">execute()</a> function. </p>
|
|
<p>The user is responsible for freeing the <a class="el" href="xqc_8h.html#acf4c0769616363086377cb527484d33e">XQC_DynamicContext</a> object returned by calling <a class="el" href="structXQC__DynamicContext__s.html#ad40117a7e2dd660ea7478c4cc5124eab" title="Called to free the resources associated with the XQC_DynamicContext.">XQC_DynamicContext::free()</a>.</p>
|
|
<dl><dt><b>Parameters:</b></dt><dd>
|
|
<table border="0" cellspacing="2" cellpadding="0">
|
|
<tr><td valign="top"></td><td valign="top"><em>expression</em> </td><td>The XQC_Expression that this function pointer is a member of. </td></tr>
|
|
<tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>context</em> </td><td>The newly created XQC_DynamicContext object.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl><dt><b>Return values:</b></dt><dd>
|
|
<table border="0" cellspacing="2" cellpadding="0">
|
|
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3fa975a11c6557d4d849e48f4034380a375" title="No error.">XQC_NO_ERROR</a></em> </td><td></td></tr>
|
|
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3fa01b5565965d03299df81f0916b8fa768" title="An implementation specific error has occurred.">XQC_INTERNAL_ERROR</a></em> </td><td></td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="xqc-context-item_8c-example.html#a8">xqc-context-item.c</a>.</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a3181579fa2677d43c29efd31a649726c"></a><!-- doxytag: member="XQC_Expression_s::execute" ref="a3181579fa2677d43c29efd31a649726c" args=")(const XQC_Expression *expression, const XQC_DynamicContext *context, XQC_Sequence **sequence)" -->
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname"><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3f">XQC_Error</a>(* <a class="el" href="structXQC__Expression__s.html#a3181579fa2677d43c29efd31a649726c">XQC_Expression_s::execute</a>)(const <a class="el" href="structXQC__Expression__s.html">XQC_Expression</a> *expression, const <a class="el" href="structXQC__DynamicContext__s.html">XQC_DynamicContext</a> *context, <a class="el" href="structXQC__Sequence__s.html">XQC_Sequence</a> **sequence)</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="memdoc">
|
|
|
|
<p>Executes the query represented by the XQC_Expression object using the values in the <a class="el" href="xqc_8h.html#acf4c0769616363086377cb527484d33e">XQC_DynamicContext</a> if provided. </p>
|
|
<p>An <a class="el" href="xqc_8h.html#a611c8970264183d7d0f42a8551239463">XQC_Sequence</a> object is returned which can be used to examine the results of the query execution. The user is responsible for freeing the <a class="el" href="xqc_8h.html#a611c8970264183d7d0f42a8551239463">XQC_Sequence</a> object returned by calling <a class="el" href="structXQC__Sequence__s.html#a13ab651edb4e0754cb8a032e2bce50b0" title="Called to free the resources associated with the XQC_Sequence.">XQC_Sequence::free()</a>.</p>
|
|
<dl><dt><b>Parameters:</b></dt><dd>
|
|
<table border="0" cellspacing="2" cellpadding="0">
|
|
<tr><td valign="top"></td><td valign="top"><em>expression</em> </td><td>The XQC_Expression that this function pointer is a member of. </td></tr>
|
|
<tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>The dynamic context information to use when executing the query, or 0 to use the implementation defined default dynamic context. </td></tr>
|
|
<tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>sequence</em> </td><td>The newly created XQC_Sequence object.</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl><dt><b>Return values:</b></dt><dd>
|
|
<table border="0" cellspacing="2" cellpadding="0">
|
|
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3fa975a11c6557d4d849e48f4034380a375" title="No error.">XQC_NO_ERROR</a></em> </td><td></td></tr>
|
|
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3fa01b5565965d03299df81f0916b8fa768" title="An implementation specific error has occurred.">XQC_INTERNAL_ERROR</a></em> </td><td></td></tr>
|
|
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3faeb68302bd3ceab3cb9d9473afd06248a" title="A type error has occured while preparing or executing the query.">XQC_TYPE_ERROR</a></em> </td><td></td></tr>
|
|
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="xqc_8h.html#aeb1ad206e9c38a7f84749cafe04d7a3fa1ece0ad69a59c3f0ce59b841ded10f9d" title="A dynamic error has occured while preparing or executing the query.">XQC_DYNAMIC_ERROR</a></em> </td><td></td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="xqc-basic_8c-example.html#a6">xqc-basic.c</a>, and <a class="el" href="xqc-context-item_8c-example.html#a11">xqc-context-item.c</a>.</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a6aa28a94f0ff6732c26f131bbe4d44a9"></a><!-- doxytag: member="XQC_Expression_s::free" ref="a6aa28a94f0ff6732c26f131bbe4d44a9" args=")(XQC_Expression *expression)" -->
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void(* <a class="el" href="structXQC__Expression__s.html#a6aa28a94f0ff6732c26f131bbe4d44a9">XQC_Expression_s::free</a>)(<a class="el" href="structXQC__Expression__s.html">XQC_Expression</a> *expression)</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="memdoc">
|
|
|
|
<p>Called to free the resources associated with the XQC_Expression. </p>
|
|
<dl><dt><b>Parameters:</b></dt><dd>
|
|
<table border="0" cellspacing="2" cellpadding="0">
|
|
<tr><td valign="top"></td><td valign="top"><em>expression</em> </td><td>The XQC_Expression that this function pointer is a member of </td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl><dt><b>Examples: </b></dt><dd><a class="el" href="xqc-basic_8c-example.html#a12">xqc-basic.c</a>, and <a class="el" href="xqc-context-item_8c-example.html#a17">xqc-context-item.c</a>.</dd>
|
|
</dl>
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="acc0d2caee9f7a61e68c57d18c1d4bd66"></a><!-- doxytag: member="XQC_Expression_s::get_interface" ref="acc0d2caee9f7a61e68c57d18c1d4bd66" args=")(const XQC_Expression *expression, const char *name)" -->
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void*(* <a class="el" href="structXQC__Expression__s.html#acc0d2caee9f7a61e68c57d18c1d4bd66">XQC_Expression_s::get_interface</a>)(const <a class="el" href="structXQC__Expression__s.html">XQC_Expression</a> *expression, const char *name)</td>
|
|
</tr>
|
|
</table>
|
|
</div>
|
|
<div class="memdoc">
|
|
|
|
<p>Called to retrieve an implementation specific interface. </p>
|
|
<dl><dt><b>Parameters:</b></dt><dd>
|
|
<table border="0" cellspacing="2" cellpadding="0">
|
|
<tr><td valign="top"></td><td valign="top"><em>expression</em> </td><td>The XQC_Expression that this function pointer is a member of. </td></tr>
|
|
<tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>The name that identifies the interface to return</td></tr>
|
|
</table>
|
|
</dd>
|
|
</dl>
|
|
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to the interface, or 0 if the name is not recognized by this implementation of XQC. </dd></dl>
|
|
|
|
</div>
|
|
</div>
|
|
<hr/>The documentation for this struct was generated from the following file:<ul>
|
|
<li><a class="el" href="xqc_8h_source.html">xqc.h</a></li>
|
|
</ul>
|
|
</div>
|
|
<hr size="1"/><address style="text-align: right;"><small>Generated on 8 Jul 2015 for XQilla XQC API by
|
|
<a href="http://www.doxygen.org/index.html">
|
|
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
|
|
</body>
|
|
</html>
|