Sophie

Sophie

distrib > Mandriva > 2010.0 > x86_64 > media > main-release > by-pkgid > 71fef6b9bbd764d1491dbe60964943fb > files > 165

lib64sablotron-devel-1.0.3-7mdv2010.0.x86_64.rpm

<html><head><link rel=StyleSheet href='api-content.css' TYPE='text/css' MEDIA='screen'><title>.Usage</title>
<script>
function navToEntry(entry) {
  window.location.href='api-' + entry + '.html';
}
function navToGroup(group) {
  var f = parent.frames['toc-container'];
  if (!f)
    window.open ('sparse-toc.html#' + group, 'toc_container');
  else {
    if (f.location.href.search('abc') != -1)
        f.location.href = 'sparse-toc.html#' + group;
    else
        f.location.hash = group;
  }
}
</script>
</head><body bgcolor='white'>
<!--
  -- HEADS UP!  This page was *GENERATED* by APIDOC,
  -- DO NOT EDIT THIS FILE BY HAND!
  -- See http://www.mozilla.org/projects/apidoc for information on APIDOC
  -- The original source file was sxp.xml
  -->
<h1 class='title'>SXP Reference</h1>
<center><table class='api-entry' width='100%' cellspacing='0'border='1' cellpadding='10'>
<tr><td class='entry-heading'>
<table class='entry-heading-table' width='100%' cellpadding='5'cellspacing='0'><tr>
<td class='entry-title' valign='center'><font size='+5'>Usage</font></td>
<td class='entry-type' align='center' width='25%'>General</td>
</tr></table>
</td></tr>
<tr><td class='entry-description'>
<h4 class='entry-subhead'>Description</h4>
To work with SXP, the user needs to instantiate a
<code><a href='javascript:navToEntry("SablotSituation");'>SablotSituation</a></code>, register a DOM handler (a set of DOM-like
callback functions) using <code><a href='javascript:navToEntry("SXP_registerDOMHandler");'>SXP_registerDOMHandler</a></code>, and create a
query context using <code><a href='javascript:navToEntry("SXP_createQueryContext");'>SXP_createQueryContext</a></code>.
</td></tr>
<tr><td class='entry-example'>
<h4 class='entry-subhead'>Example</h4>
<pre>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SablotSituation S;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SXP_QueryContext Q;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;DOMHandler my_domhandler=
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&getNodeType,
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/* ... more callbacks follow ... */
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;};
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/* let us say the root is 123 */
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SXP_Node root = (SXP_Node) 123;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SXP_char *result;
&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SablotCreateSituation(&S);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SXP_registerDOMHandler(S, &my_domhandler);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SXP_createQueryContext(S, &Q);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;/* perform the query with the root as the context node */
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SXP_query(Q, "//*", root, 1, 1);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SXP_getResultString(Q, &result);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;puts(result);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SXP_destroyQueryContext(Q);
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;SablotDestroySituation(S);
</pre></td></tr>
<tr><td class='entry-notes'>
<h4 class='entry-subhead'>Notes</h4>
For clarity, error checking has been omitted from the above
excerpt.
</td></tr>
<tr><td class='entry-seealso'>
<h4 class='entry-subhead'>See Also</h4>
<table class='seealso-table'>
<tr class='seealso-groups'><td>Groups</td>
<td>[ <a href='javascript:navToGroup("GROUP_General")'>General</a> ]</td></tr>
<tr class='seealso-internals'><td>Entries</td>
<td>[ <a href='javascript:navToEntry("SXP_createQueryContext");'>SXP_createQueryContext</a> | <a href='javascript:navToEntry("SXP_registerDOMHandler");'>SXP_registerDOMHandler</a> | <a href='javascript:navToEntry("SablotSituation");'>SablotSituation</a> ]</td></tr>

</table>
</td></tr>
</table></center><br>
&copy; 2001-2003 Ginger Alliance<BR><i>revision 03-01-31</i><BR>
<center>This page was generated by <a href='http://www.mozilla.org/projects/apidoc' target='other_window'><b>APIDOC</b></a></center>
</body></html>