1
0
mirror of https://gitlab.gnome.org/GNOME/libxml2.git synced 2025-03-27 18:50:07 +03:00

Finally - found the problem with the page generation (XMLPUBFUN not

* doc/html/*.html: Finally - found the problem with the
  page generation (XMLPUBFUN not recognized by gtkdoc).
  Re-created the pages using a temporary version of
  include/libxml/*.h.
* testOOMlib.c,include/libxml/encoding.h,
  include/libxml/schemasInternals.h,include/libxml/valid.h,
  include/libxml/xlink.h,include/libxml/xmlwin32version.h,
  include/libxml/xmlwin32version.h.in,
  include/libxml/xpathInternals.h: minor edit of comments
  to help automatic documentation generation
* doc/docdescr.doc: small elaboration
* doc/examples/test1.c,doc/examples/Makefile.am: re-commit
  (messed up on last try)
* xmlreader.c: minor change to clear warning.
This commit is contained in:
William M. Brack 2003-11-16 06:25:42 +00:00
parent 8d7b5c7ecd
commit 60f394e96d
57 changed files with 13651 additions and 855 deletions

View File

@ -1,3 +1,20 @@
Sun Nov 16 14:00:08 HKT 2003 William Brack <wbrack@mmm.com.hk>
* doc/html/*.html: Finally - found the problem with the
page generation (XMLPUBFUN not recognized by gtkdoc).
Re-created the pages using a temporary version of
include/libxml/*.h.
* testOOMlib.c,include/libxml/encoding.h,
include/libxml/schemasInternals.h,include/libxml/valid.h,
include/libxml/xlink.h,include/libxml/xmlwin32version.h,
include/libxml/xmlwin32version.h.in,
include/libxml/xpathInternals.h: minor edit of comments
to help automatic documentation generation
* doc/docdescr.doc: small elaboration
* doc/examples/test1.c,doc/examples/Makefile.am: re-commit
(messed up on last try)
* xmlreader.c: minor change to clear warning.
Sat Nov 15 19:20:32 CET 2003 Daniel Veillard <daniel@veillard.com>
* Copyright: fixed some wording

View File

@ -54,6 +54,7 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
Steps 7 and 8 are performed with the command "make web"
1) Generate libxml-decl.txt, libxml-decl-list.txt and libxml-sections.txt:
make scan, or,
gtkdoc-scan --module=libxml --source-dir=../ \
--ignore-headers="acconfig.h config.h win32config.h trio.h triostr.h
triop.h config-m ac.h XMLTestPrefix2.h XMLTestPrefix.h
@ -63,9 +64,11 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
These three files are used by the gdk-doc routines in the following steps.
2) Generate the sgml documentation in the subdirectory "tmpl":
make templates, or,
gtkdoc-mktmpl --module=libxml
3) Generate the xml documentation in the subdirectory "xml":
make xml, or,
gtkdoc-mkdb --module=libxml --source-dir=../ --output-format=xml \
--main-sgml-file=gnome-xml.xml
@ -75,6 +78,7 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
titles.
4) Generate the main html documentation in the subdirectory "html":
make html, or,
cd html
gtkdoc-mkhtml libxml ../gnome-xml.xml
cd ../
@ -101,7 +105,7 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
information on the api's in the file "libxml2-api.xml", but that step is
now being done by a separate script.
7) Generate the site's main page:
7) Generate the site's main pages:
xsltproc --nonet --html --output index.html site.xsl xml.html
All of the "top-level" pages (except xmlreader.html and guidelines.html)
@ -114,6 +118,7 @@ NOTE: Steps 1 through 5 are performed with the command "make rebuild";
xsltproc --nonet --output ../NEWS news.xsl news.html
10)Generate the XML Software Autoupdate file libxml2.xsa:
make libxml2.xsa, or,
xsltproc --nonet --output libxml2.xsa xsa.xsl news.html
11)Manually generate xmlcatalog.1 and xmllint.1 using manpages/docbook.xsl

View File

@ -19,7 +19,7 @@ install-data-local:
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
-@INSTALL@ -m 0644 $(srcdir)/*.html $(srcdir)/*.c $(srcdir)/*.xml $(srcdir)/*.xsl $(srcdir)/*.out $(DESTDIR)$(TARGET_DIR)
EXTRA_DIST=examples.xsl index.py test1.xml examples.xml test2.xml tree1.out
EXTRA_DIST=examples.xsl index.py examples.xml test1.xml test2.xml tree1.out
noinst_PROGRAMS=xpath1 parse1 parse2 tree1

View File

@ -25,7 +25,7 @@
* Prints the names of the all the xml elements
* that are siblings or children of a given xml node.
*/
void
static void
print_element_names(xmlNode * a_node)
{
xmlNode *cur_node = NULL;

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlwin32version.html" title="xmlwin32version"><link rel="next" href="libxml-dict.html" title="dict"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlwin32version.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-dict.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-DOCBparser"></a><div class="titlepage"></div><div class="refnamediv"><h2>DOCBparser</h2><p>DOCBparser &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2605365"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlwin32version.html" title="xmlwin32version"><link rel="next" href="libxml-dict.html" title="dict"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlwin32version.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-dict.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-DOCBparser"></a><div class="titlepage"></div><div class="refnamediv"><h2>DOCBparser</h2><p>DOCBparser &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2671075"></a>Synopsis</h1></h2><pre class="synopsis">
@ -39,6 +39,37 @@ typedef <a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr
typedef <a href="libxml-DOCBparser.html#docbParserInput">docbParserInput</a>;
typedef <a href="libxml-DOCBparser.html#docbParserInputPtr">docbParserInputPtr</a>;
typedef <a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a>;
int <a href="libxml-DOCBparser.html#docbEncodeEntities">docbEncodeEntities</a> (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen,
int quoteChar);
<a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> <a href="libxml-DOCBparser.html#docbSAXParseDoc">docbSAXParseDoc</a> (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *encoding,
<a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
void *userData);
<a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> <a href="libxml-DOCBparser.html#docbParseDoc">docbParseDoc</a> (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *encoding);
<a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> <a href="libxml-DOCBparser.html#docbSAXParseFile">docbSAXParseFile</a> (const char *filename,
const char *encoding,
<a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
void *userData);
<a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> <a href="libxml-DOCBparser.html#docbParseFile">docbParseFile</a> (const char *filename,
const char *encoding);
void <a href="libxml-DOCBparser.html#docbFreeParserCtxt">docbFreeParserCtxt</a> (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt);
<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> <a href="libxml-DOCBparser.html#docbCreatePushParserCtxt">docbCreatePushParserCtxt</a> (<a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
void *user_data,
const char *chunk,
int size,
const char *filename,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
int <a href="libxml-DOCBparser.html#docbParseChunk">docbParseChunk</a> (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt,
const char *chunk,
int size,
int terminate);
<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> <a href="libxml-DOCBparser.html#docbCreateFileParserCtxt">docbCreateFileParserCtxt</a> (const char *filename,
const char *encoding);
int <a href="libxml-DOCBparser.html#docbParseDocument">docbParseDocument</a> (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="docbParserCtxt"></a>docbParserCtxt</h3><pre class="programlisting">typedef xmlParserCtxt docbParserCtxt;
@ -62,4 +93,114 @@ typedef <a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a>;
</p></div><hr><div class="refsect2"><h3><a name="docbDocPtr"></a>docbDocPtr</h3><pre class="programlisting">typedef xmlDocPtr docbDocPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlwin32version.html"><b>&lt;&lt; xmlwin32version</b></a></td><td align="right"><a accesskey="n" href="libxml-dict.html"><b>dict &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="docbEncodeEntities"></a>docbEncodeEntities ()</h3><pre class="programlisting">int docbEncodeEntities (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen,
int quoteChar);</pre><p>
Take a block of UTF-8 chars in and try to convert it to an ASCII
plus SGML entities block of chars out.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a pointer to an array of bytes to store the result
</td></tr><tr><td><span class="term"><i><tt>outlen</tt></i>:</span></td><td> the length of <i><tt>out</tt></i>
</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to an array of UTF-8 chars
</td></tr><tr><td><span class="term"><i><tt>inlen</tt></i>:</span></td><td> the length of <i><tt>in</tt></i>
</td></tr><tr><td><span class="term"><i><tt>quoteChar</tt></i>:</span></td><td> the quote character to escape (' or ") or zero.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, -2 if the transcoding fails, or -1 otherwise
The value of <i><tt>inlen</tt></i> after return is the number of octets consumed
as the return value is positive, else unpredictable.
The value of <i><tt>outlen</tt></i> after return is the number of octets consumed.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbSAXParseDoc"></a>docbSAXParseDoc ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> docbSAXParseDoc (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *encoding,
<a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
void *userData);</pre><p>
parse an SGML in-memory document and build a tree.
It use the given SAX function block to handle the parsing callback.
If sax is NULL, fallback to the default DOM tree building routines.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to an array of xmlChar
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the SGML document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> the SAX handler block
</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> if using SAX, this pointer will be provided on callbacks.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbParseDoc"></a>docbParseDoc ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> docbParseDoc (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *encoding);</pre><p>
parse an SGML in-memory document and build a tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to an array of xmlChar
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the SGML document encoding, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbSAXParseFile"></a>docbSAXParseFile ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> docbSAXParseFile (const char *filename,
const char *encoding,
<a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
void *userData);</pre><p>
parse an SGML file and build a tree. Automatic support for ZLIB/Compress
compressed document is provided by default if found at compile-time.
It use the given SAX function block to handle the parsing callback.
If sax is NULL, fallback to the default DOM tree building routines.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the SGML document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> the SAX handler block
</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> if using SAX, this pointer will be provided on callbacks.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbParseFile"></a>docbParseFile ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbDocPtr">docbDocPtr</a> docbParseFile (const char *filename,
const char *encoding);</pre><p>
parse a Docbook SGML file and build a tree. Automatic support for
ZLIB/Compress compressed document is provided by default if found
at compile-time.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing document encoding, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbFreeParserCtxt"></a>docbFreeParserCtxt ()</h3><pre class="programlisting">void docbFreeParserCtxt (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt);</pre><p>
Free all the memory used by a parser context. However the parsed
document in ctxt-&gt;myDoc is not freed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an SGML parser context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbCreatePushParserCtxt"></a>docbCreatePushParserCtxt ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> docbCreatePushParserCtxt (<a href="libxml-DOCBparser.html#docbSAXHandlerPtr">docbSAXHandlerPtr</a> sax,
void *user_data,
const char *chunk,
int size,
const char *filename,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a parser context for using the DocBook SGML parser in push mode
To allow content encoding detection, <i><tt>size</tt></i> should be &gt;= 4
The value of <i><tt>filename</tt></i> is used for fetching external entities
and error/warning reports.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> a SAX handler
</td></tr><tr><td><span class="term"><i><tt>user_data</tt></i>:</span></td><td> The user data returned on SAX callbacks
</td></tr><tr><td><span class="term"><i><tt>chunk</tt></i>:</span></td><td> a pointer to an array of chars
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> number of chars in the array
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> an optional file name or URI
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> an optional encoding
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser context or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbParseChunk"></a>docbParseChunk ()</h3><pre class="programlisting">int docbParseChunk (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt,
const char *chunk,
int size,
int terminate);</pre><p>
Parse a Chunk of memory</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an XML parser context
</td></tr><tr><td><span class="term"><i><tt>chunk</tt></i>:</span></td><td> an char array
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size in byte of the chunk
</td></tr><tr><td><span class="term"><i><tt>terminate</tt></i>:</span></td><td> last chunk indicator
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>zero if no error, the xmlParserErrors otherwise.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbCreateFileParserCtxt"></a>docbCreateFileParserCtxt ()</h3><pre class="programlisting"><a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> docbCreateFileParserCtxt (const char *filename,
const char *encoding);</pre><p>
Create a parser context for a file content.
Automatic support for ZLIB/Compress compressed document is provided
by default if found at compile-time.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the SGML document encoding, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser context or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="docbParseDocument"></a>docbParseDocument ()</h3><pre class="programlisting">int docbParseDocument (<a href="libxml-DOCBparser.html#docbParserCtxtPtr">docbParserCtxtPtr</a> ctxt);</pre><p>
parse an SGML document (and build a tree if using the standard SAX
interface).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an SGML parser context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0, -1 in case of error. the parser context is augmented
as a result of the parsing.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlwin32version.html"><b>&lt;&lt; xmlwin32version</b></a></td><td align="right"><a accesskey="n" href="libxml-dict.html"><b>dict &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-entities.html" title="entities"><link rel="next" href="libxml-valid.html" title="valid"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-entities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-valid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-HTMLparser"></a><div class="titlepage"></div><div class="refnamediv"><h2>HTMLparser</h2><p>HTMLparser &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2684037"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-entities.html" title="entities"><link rel="next" href="libxml-valid.html" title="valid"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-entities.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-valid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-HTMLparser"></a><div class="titlepage"></div><div class="refnamediv"><h2>HTMLparser</h2><p>HTMLparser &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2762484"></a>Synopsis</h1></h2><pre class="synopsis">
@ -45,7 +45,109 @@ struct <a href="libxml-HTMLparser.html#htmlElemDesc">htmlElemDesc</a>;
typedef <a href="libxml-HTMLparser.html#htmlElemDescPtr">htmlElemDescPtr</a>;
struct <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>;
typedef <a href="libxml-HTMLparser.html#htmlEntityDescPtr">htmlEntityDescPtr</a>;
const <a href="libxml-HTMLparser.html#htmlElemDesc">htmlElemDesc</a>* <a href="libxml-HTMLparser.html#htmlTagLookup">htmlTagLookup</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *tag);
const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* <a href="libxml-HTMLparser.html#htmlEntityLookup">htmlEntityLookup</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* <a href="libxml-HTMLparser.html#htmlEntityValueLookup">htmlEntityValueLookup</a> (unsigned int value);
int <a href="libxml-HTMLparser.html#htmlIsAutoClosed">htmlIsAutoClosed</a> (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
<a href="libxml-HTMLparser.html#htmlNodePtr">htmlNodePtr</a> elem);
int <a href="libxml-HTMLparser.html#htmlAutoCloseTag">htmlAutoCloseTag</a> (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
<a href="libxml-HTMLparser.html#htmlNodePtr">htmlNodePtr</a> elem);
const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* <a href="libxml-HTMLparser.html#htmlParseEntityRef">htmlParseEntityRef</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> **str);
int <a href="libxml-HTMLparser.html#htmlParseCharRef">htmlParseCharRef</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
void <a href="libxml-HTMLparser.html#htmlParseElement">htmlParseElement</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> <a href="libxml-HTMLparser.html#htmlCreateMemoryParserCtxt">htmlCreateMemoryParserCtxt</a>
(const char *buffer,
int size);
int <a href="libxml-HTMLparser.html#htmlParseDocument">htmlParseDocument</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlSAXParseDoc">htmlSAXParseDoc</a> (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *encoding,
<a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
void *userData);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlParseDoc">htmlParseDoc</a> (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *encoding);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlSAXParseFile">htmlSAXParseFile</a> (const char *filename,
const char *encoding,
<a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
void *userData);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlParseFile">htmlParseFile</a> (const char *filename,
const char *encoding);
int <a href="libxml-HTMLparser.html#UTF8ToHtml">UTF8ToHtml</a> (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen);
int <a href="libxml-HTMLparser.html#htmlEncodeEntities">htmlEncodeEntities</a> (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen,
int quoteChar);
int <a href="libxml-HTMLparser.html#htmlIsScriptAttribute">htmlIsScriptAttribute</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
int <a href="libxml-HTMLparser.html#htmlHandleOmittedElem">htmlHandleOmittedElem</a> (int val);
<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> <a href="libxml-HTMLparser.html#htmlCreatePushParserCtxt">htmlCreatePushParserCtxt</a> (<a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
void *user_data,
const char *chunk,
int size,
const char *filename,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
int <a href="libxml-HTMLparser.html#htmlParseChunk">htmlParseChunk</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
const char *chunk,
int size,
int terminate);
void <a href="libxml-HTMLparser.html#htmlFreeParserCtxt">htmlFreeParserCtxt</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
enum <a href="libxml-HTMLparser.html#htmlParserOption">htmlParserOption</a>;
void <a href="libxml-HTMLparser.html#htmlCtxtReset">htmlCtxtReset</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);
int <a href="libxml-HTMLparser.html#htmlCtxtUseOptions">htmlCtxtUseOptions</a> (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadDoc">htmlReadDoc</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *URL,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadFile">htmlReadFile</a> (const char *URL,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadMemory">htmlReadMemory</a> (const char *buffer,
int size,
const char *URL,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadFd">htmlReadFd</a> (int fd,
const char *URL,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlReadIO">htmlReadIO</a> (<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
const char *URL,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadDoc">htmlCtxtReadDoc</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *URL,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadFile">htmlCtxtReadFile</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
const char *filename,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadMemory">htmlCtxtReadMemory</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
const char *buffer,
int size,
const char *URL,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadFd">htmlCtxtReadFd</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
int fd,
const char *URL,
const char *encoding,
int options);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLparser.html#htmlCtxtReadIO">htmlCtxtReadIO</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
const char *URL,
const char *encoding,
int options);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="htmlParserCtxt"></a>htmlParserCtxt</h3><pre class="programlisting">typedef xmlParserCtxt htmlParserCtxt;
@ -120,7 +222,207 @@ enum <a href="libxml-HTMLparser.html#htmlParserOption">htmlParserOption</
</p></div><hr><div class="refsect2"><h3><a name="htmlEntityDescPtr"></a>htmlEntityDescPtr</h3><pre class="programlisting">typedef htmlEntityDesc *htmlEntityDescPtr;
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="htmlParserOption"></a>enum htmlParserOption</h3><pre class="programlisting">typedef enum {
</p></div><hr><div class="refsect2"><h3><a name="htmlTagLookup"></a>htmlTagLookup ()</h3><pre class="programlisting">const <a href="libxml-HTMLparser.html#htmlElemDesc">htmlElemDesc</a>* htmlTagLookup (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *tag);</pre><p>
Lookup the HTML tag in the ElementTable</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tag</tt></i>:</span></td><td> The tag name in lowercase
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the related htmlElemDescPtr or NULL if not found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlEntityLookup"></a>htmlEntityLookup ()</h3><pre class="programlisting">const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* htmlEntityLookup (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Lookup the given entity in EntitiesTable
</p><p>
TODO: the linear scan is really ugly, an hash table is really needed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the associated htmlEntityDescPtr if found, NULL otherwise.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlEntityValueLookup"></a>htmlEntityValueLookup ()</h3><pre class="programlisting">const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* htmlEntityValueLookup (unsigned int value);</pre><p>
Lookup the given entity in EntitiesTable
</p><p>
TODO: the linear scan is really ugly, an hash table is really needed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the entity's unicode value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the associated htmlEntityDescPtr if found, NULL otherwise.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlIsAutoClosed"></a>htmlIsAutoClosed ()</h3><pre class="programlisting">int htmlIsAutoClosed (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
<a href="libxml-HTMLparser.html#htmlNodePtr">htmlNodePtr</a> elem);</pre><p>
The HTML DTD allows a tag to implicitly close other tags.
The list is kept in htmlStartClose array. This function checks
if a tag is autoclosed by one of it's child</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the HTML document
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the HTML element
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if autoclosed, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlAutoCloseTag"></a>htmlAutoCloseTag ()</h3><pre class="programlisting">int htmlAutoCloseTag (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
<a href="libxml-HTMLparser.html#htmlNodePtr">htmlNodePtr</a> elem);</pre><p>
The HTML DTD allows a tag to implicitly close other tags.
The list is kept in htmlStartClose array. This function checks
if the element or one of it's children would autoclose the
given tag.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the HTML document
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The tag name
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the HTML element
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if autoclose, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseEntityRef"></a>htmlParseEntityRef ()</h3><pre class="programlisting">const <a href="libxml-HTMLparser.html#htmlEntityDesc">htmlEntityDesc</a>* htmlParseEntityRef (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> **str);</pre><p>
parse an HTML ENTITY references
</p><p>
[68] EntityRef ::= '&amp;' Name ';'</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> location to store the entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the associated htmlEntityDescPtr if found, or NULL otherwise,
if non-NULL *str will have to be freed by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseCharRef"></a>htmlParseCharRef ()</h3><pre class="programlisting">int htmlParseCharRef (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
parse Reference declarations
</p><p>
[66] CharRef ::= '&amp;#' [0-9]+ ';' |
'&amp;<GTKDOCLINK HREF="x">x</GTKDOCLINK>' [0-9a-fA-F]+ ';'</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the value parsed (as an int)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseElement"></a>htmlParseElement ()</h3><pre class="programlisting">void htmlParseElement (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
parse an HTML element, this is highly recursive
</p><p>
[39] element ::= EmptyElemTag | STag content ETag
</p><p>
[41] Attribute ::= Name Eq AttValue</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCreateMemoryParserCtxt"></a>htmlCreateMemoryParserCtxt ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> htmlCreateMemoryParserCtxt
(const char *buffer,
int size);</pre><p>
Create a parser context for an HTML in-memory document.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser context or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseDocument"></a>htmlParseDocument ()</h3><pre class="programlisting">int htmlParseDocument (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
parse an HTML document (and build a tree if using the standard SAX
interface).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0, -1 in case of error. the parser context is augmented
as a result of the parsing.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSAXParseDoc"></a>htmlSAXParseDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlSAXParseDoc (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *encoding,
<a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
void *userData);</pre><p>
Parse an HTML in-memory document. If sax is not NULL, use the SAX callbacks
to handle parse events. If sax is NULL, fallback to the default DOM
behavior and return a tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to an array of xmlChar
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the HTML document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> the SAX handler block
</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> if using SAX, this pointer will be provided on callbacks.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree unless SAX is NULL or the document is
not well formed.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseDoc"></a>htmlParseDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlParseDoc (<a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *encoding);</pre><p>
parse an HTML in-memory document and build a tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to an array of xmlChar
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the HTML document encoding, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSAXParseFile"></a>htmlSAXParseFile ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlSAXParseFile (const char *filename,
const char *encoding,
<a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
void *userData);</pre><p>
parse an HTML file and build a tree. Automatic support for ZLIB/Compress
compressed document is provided by default if found at compile-time.
It use the given SAX function block to handle the parsing callback.
If sax is NULL, fallback to the default DOM tree building routines.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the HTML document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> the SAX handler block
</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> if using SAX, this pointer will be provided on callbacks.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree unless SAX is NULL or the document is
not well formed.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseFile"></a>htmlParseFile ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlParseFile (const char *filename,
const char *encoding);</pre><p>
parse an HTML file and build a tree. Automatic support for ZLIB/Compress
compressed document is provided by default if found at compile-time.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> a free form C string describing the HTML document encoding, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="UTF8ToHtml"></a>UTF8ToHtml ()</h3><pre class="programlisting">int UTF8ToHtml (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen);</pre><p>
Take a block of UTF-8 chars in and try to convert it to an ASCII
plus HTML entities block of chars out.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a pointer to an array of bytes to store the result
</td></tr><tr><td><span class="term"><i><tt>outlen</tt></i>:</span></td><td> the length of <i><tt>out</tt></i>
</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to an array of UTF-8 chars
</td></tr><tr><td><span class="term"><i><tt>inlen</tt></i>:</span></td><td> the length of <i><tt>in</tt></i>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, -2 if the transcoding fails, or -1 otherwise
The value of <i><tt>inlen</tt></i> after return is the number of octets consumed
as the return value is positive, else unpredictable.
The value of <i><tt>outlen</tt></i> after return is the number of octets consumed.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlEncodeEntities"></a>htmlEncodeEntities ()</h3><pre class="programlisting">int htmlEncodeEntities (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen,
int quoteChar);</pre><p>
Take a block of UTF-8 chars in and try to convert it to an ASCII
plus HTML entities block of chars out.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a pointer to an array of bytes to store the result
</td></tr><tr><td><span class="term"><i><tt>outlen</tt></i>:</span></td><td> the length of <i><tt>out</tt></i>
</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to an array of UTF-8 chars
</td></tr><tr><td><span class="term"><i><tt>inlen</tt></i>:</span></td><td> the length of <i><tt>in</tt></i>
</td></tr><tr><td><span class="term"><i><tt>quoteChar</tt></i>:</span></td><td> the quote character to escape (' or ") or zero.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, -2 if the transcoding fails, or -1 otherwise
The value of <i><tt>inlen</tt></i> after return is the number of octets consumed
as the return value is positive, else unpredictable.
The value of <i><tt>outlen</tt></i> after return is the number of octets consumed.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlIsScriptAttribute"></a>htmlIsScriptAttribute ()</h3><pre class="programlisting">int htmlIsScriptAttribute (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Check if an attribute is of content type Script</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> an attribute name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 is the attribute is a script 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlHandleOmittedElem"></a>htmlHandleOmittedElem ()</h3><pre class="programlisting">int htmlHandleOmittedElem (int val);</pre><p>
Set and return the previous value for handling HTML omitted tags.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> int 0 or 1
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the last value for 0 for no handling, 1 for auto insertion.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCreatePushParserCtxt"></a>htmlCreatePushParserCtxt ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> htmlCreatePushParserCtxt (<a href="libxml-HTMLparser.html#htmlSAXHandlerPtr">htmlSAXHandlerPtr</a> sax,
void *user_data,
const char *chunk,
int size,
const char *filename,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a parser context for using the HTML parser in push mode
The value of <i><tt>filename</tt></i> is used for fetching external entities
and error/warning reports.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> a SAX handler
</td></tr><tr><td><span class="term"><i><tt>user_data</tt></i>:</span></td><td> The user data returned on SAX callbacks
</td></tr><tr><td><span class="term"><i><tt>chunk</tt></i>:</span></td><td> a pointer to an array of chars
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> number of chars in the array
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> an optional file name or URI
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> an optional encoding
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser context or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParseChunk"></a>htmlParseChunk ()</h3><pre class="programlisting">int htmlParseChunk (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
const char *chunk,
int size,
int terminate);</pre><p>
Parse a Chunk of memory</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><i><tt>chunk</tt></i>:</span></td><td> an char array
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size in byte of the chunk
</td></tr><tr><td><span class="term"><i><tt>terminate</tt></i>:</span></td><td> last chunk indicator
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>zero if no error, the xmlParserErrors otherwise.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlFreeParserCtxt"></a>htmlFreeParserCtxt ()</h3><pre class="programlisting">void htmlFreeParserCtxt (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
Free all the memory used by a parser context. However the parsed
document in ctxt-&gt;myDoc is not freed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlParserOption"></a>enum htmlParserOption</h3><pre class="programlisting">typedef enum {
HTML_PARSE_NOERROR = 1&lt;&lt;5, /* suppress error reports */
HTML_PARSE_NOWARNING= 1&lt;&lt;6, /* suppress warning reports */
HTML_PARSE_PEDANTIC = 1&lt;&lt;7, /* pedantic error reporting */
@ -129,4 +431,149 @@ enum <a href="libxml-HTMLparser.html#htmlParserOption">htmlParserOption</
} htmlParserOption;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-entities.html"><b>&lt;&lt; entities</b></a></td><td align="right"><a accesskey="n" href="libxml-valid.html"><b>valid &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="htmlCtxtReset"></a>htmlCtxtReset ()</h3><pre class="programlisting">void htmlCtxtReset (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt);</pre><p>
Reset a parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtUseOptions"></a>htmlCtxtUseOptions ()</h3><pre class="programlisting">int htmlCtxtUseOptions (<a href="libxml-HTMLparser.html#htmlParserCtxtPtr">htmlParserCtxtPtr</a> ctxt,
int options);</pre><p>
Applies the options to the parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success, the set of unknown or unimplemented options
in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadDoc"></a>htmlReadDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadDoc (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *URL,
const char *encoding,
int options);</pre><p>
parse an XML in-memory document and build a tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to a zero terminated string
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadFile"></a>htmlReadFile ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadFile (const char *URL,
const char *encoding,
int options);</pre><p>
parse an XML file from the filesystem or the network.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadMemory"></a>htmlReadMemory ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadMemory (const char *buffer,
int size,
const char *URL,
const char *encoding,
int options);</pre><p>
parse an XML in-memory document and build a tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadFd"></a>htmlReadFd ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadFd (int fd,
const char *URL,
const char *encoding,
int options);</pre><p>
parse an XML from a file descriptor and build a tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>fd</tt></i>:</span></td><td> an open file descriptor
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlReadIO"></a>htmlReadIO ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlReadIO (<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
const char *URL,
const char *encoding,
int options);</pre><p>
parse an HTML document from I/O functions and source and build a tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ioread</tt></i>:</span></td><td> an I/O read function
</td></tr><tr><td><span class="term"><i><tt>ioclose</tt></i>:</span></td><td> an I/O close function
</td></tr><tr><td><span class="term"><i><tt>ioctx</tt></i>:</span></td><td> an I/O handler
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadDoc"></a>htmlCtxtReadDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadDoc (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *URL,
const char *encoding,
int options);</pre><p>
parse an XML in-memory document and build a tree.
This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to a zero terminated string
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadFile"></a>htmlCtxtReadFile ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadFile (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
const char *filename,
const char *encoding,
int options);</pre><p>
parse an XML file from the filesystem or the network.
This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> a file or URL
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadMemory"></a>htmlCtxtReadMemory ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadMemory (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
const char *buffer,
int size,
const char *URL,
const char *encoding,
int options);</pre><p>
parse an XML in-memory document and build a tree.
This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadFd"></a>htmlCtxtReadFd ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadFd (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
int fd,
const char *URL,
const char *encoding,
int options);</pre><p>
parse an XML from a file descriptor and build a tree.
This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><i><tt>fd</tt></i>:</span></td><td> an open file descriptor
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlCtxtReadIO"></a>htmlCtxtReadIO ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlCtxtReadIO (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
const char *URL,
const char *encoding,
int options);</pre><p>
parse an HTML document from I/O functions and source and build a tree.
This reuses the existing <i><tt>ctxt</tt></i> parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an HTML parser context
</td></tr><tr><td><span class="term"><i><tt>ioread</tt></i>:</span></td><td> an I/O read function
</td></tr><tr><td><span class="term"><i><tt>ioclose</tt></i>:</span></td><td> an I/O close function
</td></tr><tr><td><span class="term"><i><tt>ioctx</tt></i>:</span></td><td> an I/O handler
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of htmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-entities.html"><b>&lt;&lt; entities</b></a></td><td align="right"><a accesskey="n" href="libxml-valid.html"><b>valid &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-list.html" title="list"><link rel="next" href="libxml-parserInternals.html" title="parserInternals"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-list.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-parserInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-HTMLtree"></a><div class="titlepage"></div><div class="refnamediv"><h2>HTMLtree</h2><p>HTMLtree &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2700069"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-list.html" title="list"><link rel="next" href="libxml-parserInternals.html" title="parserInternals"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-list.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-parserInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-HTMLtree"></a><div class="titlepage"></div><div class="refnamediv"><h2>HTMLtree</h2><p>HTMLtree &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2610789"></a>Synopsis</h1></h2><pre class="synopsis">
@ -37,6 +37,55 @@
#define <a href="libxml-HTMLtree.html#HTML-COMMENT-NODE-CAPS">HTML_COMMENT_NODE</a>
#define <a href="libxml-HTMLtree.html#HTML-PRESERVE-NODE-CAPS">HTML_PRESERVE_NODE</a>
#define <a href="libxml-HTMLtree.html#HTML-PI-NODE-CAPS">HTML_PI_NODE</a>
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLtree.html#htmlNewDoc">htmlNewDoc</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID);
<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> <a href="libxml-HTMLtree.html#htmlNewDocNoDtD">htmlNewDocNoDtD</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-HTMLtree.html#htmlGetMetaEncoding">htmlGetMetaEncoding</a> (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc);
int <a href="libxml-HTMLtree.html#htmlSetMetaEncoding">htmlSetMetaEncoding</a> (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *encoding);
void <a href="libxml-HTMLtree.html#htmlDocDumpMemory">htmlDocDumpMemory</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **mem,
int *size);
int <a href="libxml-HTMLtree.html#htmlDocDump">htmlDocDump</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *f,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur);
int <a href="libxml-HTMLtree.html#htmlSaveFile">htmlSaveFile</a> (const char *filename,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur);
int <a href="libxml-HTMLtree.html#htmlNodeDump">htmlNodeDump</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur);
void <a href="libxml-HTMLtree.html#htmlNodeDumpFile">htmlNodeDumpFile</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur);
int <a href="libxml-HTMLtree.html#htmlNodeDumpFileFormat">htmlNodeDumpFileFormat</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
const char *encoding,
int format);
int <a href="libxml-HTMLtree.html#htmlSaveFileEnc">htmlSaveFileEnc</a> (const char *filename,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
const char *encoding);
int <a href="libxml-HTMLtree.html#htmlSaveFileFormat">htmlSaveFileFormat</a> (const char *filename,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
const char *encoding,
int format);
void <a href="libxml-HTMLtree.html#htmlNodeDumpFormatOutput">htmlNodeDumpFormatOutput</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
const char *encoding,
int format);
void <a href="libxml-HTMLtree.html#htmlDocContentDumpOutput">htmlDocContentDumpOutput</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
const char *encoding);
void <a href="libxml-HTMLtree.html#htmlDocContentDumpFormatOutput">htmlDocContentDumpFormatOutput</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
const char *encoding,
int format);
void <a href="libxml-HTMLtree.html#htmlNodeDumpOutput">htmlNodeDumpOutput</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
const char *encoding);
int <a href="libxml-HTMLtree.html#htmlIsBooleanAttr">htmlIsBooleanAttr</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="HTML-TEXT-NODE-CAPS"></a>HTML_TEXT_NODE</h3><pre class="programlisting">#define HTML_TEXT_NODE XML_TEXT_NODE
@ -64,4 +113,158 @@ the same way as a CDATA section in an XML document.</p><p>
Macro. A processing instruction in a HTML document is really implemented
the same way as a processing instruction in an XML document.</p><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-list.html"><b>&lt;&lt; list</b></a></td><td align="right"><a accesskey="n" href="libxml-parserInternals.html"><b>parserInternals &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="htmlNewDoc"></a>htmlNewDoc ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlNewDoc (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID);</pre><p>
Creates a new HTML document</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> URI for the dtd, or NULL
</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the external ID of the DTD, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new document
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNewDocNoDtD"></a>htmlNewDocNoDtD ()</h3><pre class="programlisting"><a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> htmlNewDocNoDtD (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID);</pre><p>
Creates a new HTML document without a DTD node if <i><tt>URI</tt></i> and <i><tt>ExternalID</tt></i>
are NULL</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> URI for the dtd, or NULL
</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the external ID of the DTD, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new document, do not initialize the DTD if not provided
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlGetMetaEncoding"></a>htmlGetMetaEncoding ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* htmlGetMetaEncoding (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc);</pre><p>
Encoding definition lookup in the Meta tags</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the current encoding as flagged in the HTML source
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSetMetaEncoding"></a>htmlSetMetaEncoding ()</h3><pre class="programlisting">int htmlSetMetaEncoding (<a href="libxml-HTMLparser.html#htmlDocPtr">htmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *encoding);</pre><p>
Sets the current encoding in the Meta tags
NOTE: this will not change the document content encoding, just
the META flag associated.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlDocDumpMemory"></a>htmlDocDumpMemory ()</h3><pre class="programlisting">void htmlDocDumpMemory (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **mem,
int *size);</pre><p>
Dump an HTML document in memory and return the xmlChar * and it's size.
It's up to the caller to free the memory.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>mem</tt></i>:</span></td><td> OUT: the memory pointer
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> OUT: the memory length
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlDocDump"></a>htmlDocDump ()</h3><pre class="programlisting">int htmlDocDump (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *f,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur);</pre><p>
Dump an HTML document to an open FILE.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the FILE*
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSaveFile"></a>htmlSaveFile ()</h3><pre class="programlisting">int htmlSaveFile (const char *filename,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur);</pre><p>
Dump an HTML document to a file. If <i><tt>filename</tt></i> is "-" the stdout file is
used.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename (or URL)
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDump"></a>htmlNodeDump ()</h3><pre class="programlisting">int htmlNodeDump (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur);</pre><p>
Dump an HTML node, recursive behaviour,children are printed too,
and formatting returns are added.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte written or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDumpFile"></a>htmlNodeDumpFile ()</h3><pre class="programlisting">void htmlNodeDumpFile (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur);</pre><p>
Dump an HTML node, recursive behaviour,children are printed too,
and formatting returns are added.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> the FILE pointer
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDumpFileFormat"></a>htmlNodeDumpFileFormat ()</h3><pre class="programlisting">int htmlNodeDumpFileFormat (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
const char *encoding,
int format);</pre><p>
Dump an HTML node, recursive behaviour,children are printed too.
</p><p>
TODO: if encoding == NULL try to save in the doc encoding</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> the FILE pointer
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> should formatting spaces been added
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSaveFileEnc"></a>htmlSaveFileEnc ()</h3><pre class="programlisting">int htmlSaveFileEnc (const char *filename,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
const char *encoding);</pre><p>
Dump an HTML document to a file using a given encoding
and formatting returns/spaces are added.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlSaveFileFormat"></a>htmlSaveFileFormat ()</h3><pre class="programlisting">int htmlSaveFileFormat (const char *filename,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
const char *encoding,
int format);</pre><p>
Dump an HTML document to a file using a given encoding.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> should formatting spaces been added
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> the number of byte written or -1 in case of failure.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDumpFormatOutput"></a>htmlNodeDumpFormatOutput ()</h3><pre class="programlisting">void htmlNodeDumpFormatOutput (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
const char *encoding,
int format);</pre><p>
Dump an HTML node, recursive behaviour,children are printed too.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> should formatting spaces been added
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlDocContentDumpOutput"></a>htmlDocContentDumpOutput ()</h3><pre class="programlisting">void htmlDocContentDumpOutput (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
const char *encoding);</pre><p>
Dump an HTML document. Formating return/spaces are added.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlDocContentDumpFormatOutput"></a>htmlDocContentDumpFormatOutput ()</h3><pre class="programlisting">void htmlDocContentDumpFormatOutput (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur,
const char *encoding,
int format);</pre><p>
Dump an HTML document.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> should formatting spaces been added
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlNodeDumpOutput"></a>htmlNodeDumpOutput ()</h3><pre class="programlisting">void htmlNodeDumpOutput (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur,
const char *encoding);</pre><p>
Dump an HTML node, recursive behaviour,children are printed too,
and formatting returns/spaces are added.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the HTML buffer output
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the current node
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding string
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="htmlIsBooleanAttr"></a>htmlIsBooleanAttr ()</h3><pre class="programlisting">int htmlIsBooleanAttr (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Determine if a given attribute is a boolean attribute.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the attribute to check
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> false if the attribute is not boolean, true otherwise.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-list.html"><b>&lt;&lt; list</b></a></td><td align="right"><a accesskey="n" href="libxml-parserInternals.html"><b>parserInternals &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -1,4 +1,4 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>SAX</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>SAX</title><meta name="generator" content="DocBook XSL Stylesheets V1.48"><meta name="generator" content="GTK-Doc V1.1 (XML mode)"><style type="text/css">
.synopsis, .classsynopsis {
background: #eeeeee;
border: solid 1px #aaaaaa;
@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="libxml-lib.html" title="Libxml Library Reference"><link rel="previous" href="libxml-xmlreader.html" title="xmlreader"><link rel="next" href="libxml-tree.html" title="tree"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlreader.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></img></a></td><td><a accesskey="u" href="libxml-lib.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></img></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></img></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-tree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></img></a></td></tr></table><div class="refentry" lang="en"><a name="libxml-SAX"></a><div class="titlepage"></div><div class="refnamediv"><h2>SAX</h2><p>SAX &#8212; </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xpath.html" title="xpath"><link rel="next" href="libxml-chvalid.html" title="chvalid"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xpath.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-chvalid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-SAX"></a><div class="titlepage"></div><div class="refnamediv"><h2>SAX</h2><p>SAX &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2583364"></a>Synopsis</h1></h2><pre class="synopsis">
@ -119,301 +119,305 @@ void <a href="libxml-SAX.html#comment">comment</a>
void <a href="libxml-SAX.html#cdataBlock">cdataBlock</a> (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
int len);
void <a href="libxml-SAX.html#initxmlDefaultSAXHandler">initxmlDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr,
void <a href="libxml-SAX.html#initxmlDefaultSAXHandler">initxmlDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr,
int warning);
void <a href="libxml-SAX.html#inithtmlDefaultSAXHandler">inithtmlDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr);
void <a href="libxml-SAX.html#initdocbDefaultSAXHandler">initdocbDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr);
void <a href="libxml-SAX.html#xmlDefaultSAXHandlerInit">xmlDefaultSAXHandlerInit</a> (void);
void <a href="libxml-SAX.html#htmlDefaultSAXHandlerInit">htmlDefaultSAXHandlerInit</a> (void);
void <a href="libxml-SAX.html#docbDefaultSAXHandlerInit">docbDefaultSAXHandlerInit</a> (void);
</pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
void <a href="libxml-SAX.html#inithtmlDefaultSAXHandler">inithtmlDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr);
void <a href="libxml-SAX.html#initdocbDefaultSAXHandler">initdocbDefaultSAXHandler</a> (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="getPublicId"></a>getPublicId ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* getPublicId (void *ctx);</pre><p>
Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN"</p><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="getPublicId"></a>getPublicId ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* getPublicId (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getPublicId</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetPublicId">xmlSAX2GetPublicId</a>()</p></div><p>
Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN"
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>a xmlChar *
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getSystemId"></a>getSystemId ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* getSystemId (void *ctx);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a xmlChar *
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getSystemId"></a>getSystemId ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* getSystemId (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getSystemId</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetSystemId">xmlSAX2GetSystemId</a>()</p></div><p>
Provides the system ID, basically URL or filename e.g.
http://www.sgmlsource.com/dtds/memo.dtd</p><p>
http://www.sgmlsource.com/dtds/memo.dtd
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>a xmlChar *
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="setDocumentLocator"></a>setDocumentLocator ()</h3><pre class="programlisting">void setDocumentLocator (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a xmlChar *
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="setDocumentLocator"></a>setDocumentLocator ()</h3><pre class="programlisting">void setDocumentLocator (void *ctx,
<a href="libxml-tree.html#xmlSAXLocatorPtr">xmlSAXLocatorPtr</a> loc);</pre><p>
Receive the document locator at startup, actually xmlDefaultSAXLocator
Everything is available on the context, so this is useless in our case.</p><p>
Everything is available on the context, so this is useless in our case.
DEPRECATED</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>loc</tt></i> :</span></td><td> A SAX Locator
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getLineNumber"></a>getLineNumber ()</h3><pre class="programlisting">int getLineNumber (void *ctx);</pre><p>
Provide the line number of the current parsing point.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>loc</tt></i>:</span></td><td> A SAX Locator
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getLineNumber"></a>getLineNumber ()</h3><pre class="programlisting">int getLineNumber (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getLineNumber</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetLineNumber">xmlSAX2GetLineNumber</a>()</p></div><p>
Provide the line number of the current parsing point.
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>an int
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getColumnNumber"></a>getColumnNumber ()</h3><pre class="programlisting">int getColumnNumber (void *ctx);</pre><p>
Provide the column number of the current parsing point.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an int
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getColumnNumber"></a>getColumnNumber ()</h3><pre class="programlisting">int getColumnNumber (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getColumnNumber</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetColumnNumber">xmlSAX2GetColumnNumber</a>()</p></div><p>
Provide the column number of the current parsing point.
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>an int
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="isStandalone"></a>isStandalone ()</h3><pre class="programlisting">int isStandalone (void *ctx);</pre><p>
Is this document tagged standalone ?</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an int
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="isStandalone"></a>isStandalone ()</h3><pre class="programlisting">int isStandalone (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>isStandalone</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2IsStandalone">xmlSAX2IsStandalone</a>()</p></div><p>
Is this document tagged standalone ?
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>1 if true
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="hasInternalSubset"></a>hasInternalSubset ()</h3><pre class="programlisting">int hasInternalSubset (void *ctx);</pre><p>
Does this document has an internal subset</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="hasInternalSubset"></a>hasInternalSubset ()</h3><pre class="programlisting">int hasInternalSubset (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>hasInternalSubset</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2HasInternalSubset">xmlSAX2HasInternalSubset</a>()</p></div><p>
Does this document has an internal subset
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>1 if true
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="hasExternalSubset"></a>hasExternalSubset ()</h3><pre class="programlisting">int hasExternalSubset (void *ctx);</pre><p>
Does this document has an external subset</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="hasExternalSubset"></a>hasExternalSubset ()</h3><pre class="programlisting">int hasExternalSubset (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>hasExternalSubset</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2HasExternalSubset">xmlSAX2HasExternalSubset</a>()</p></div><p>
Does this document has an external subset
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>1 if true
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="internalSubset"></a>internalSubset ()</h3><pre class="programlisting">void internalSubset (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="internalSubset"></a>internalSubset ()</h3><pre class="programlisting">void internalSubset (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><p>
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>internalSubset</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2InternalSubset">xmlSAX2InternalSubset</a>()</p></div><p>
Callback on internal subset declaration.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the root element name
</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i> :</span></td><td> the external ID
</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i> :</span></td><td> the SYSTEM ID (e.g. filename or URL)
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="externalSubset"></a>externalSubset ()</h3><pre class="programlisting">void externalSubset (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the root element name
</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the external ID
</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i>:</span></td><td> the SYSTEM ID (e.g. filename or URL)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="externalSubset"></a>externalSubset ()</h3><pre class="programlisting">void externalSubset (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><p>
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>externalSubset</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2ExternalSubset">xmlSAX2ExternalSubset</a>()</p></div><p>
Callback on external subset declaration.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the root element name
</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i> :</span></td><td> the external ID
</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i> :</span></td><td> the SYSTEM ID (e.g. filename or URL)
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getEntity"></a>getEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> getEntity (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Get an entity by name</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the root element name
</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the external ID
</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i>:</span></td><td> the SYSTEM ID (e.g. filename or URL)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getEntity"></a>getEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> getEntity (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getEntity</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetEntity">xmlSAX2GetEntity</a>()</p></div><p>
Get an entity by name
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the xmlEntityPtr if found.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getParameterEntity"></a>getParameterEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> getParameterEntity (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Get a parameter entity by name</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlEntityPtr if found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getParameterEntity"></a>getParameterEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> getParameterEntity (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>getParameterEntity</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2GetParameterEntity">xmlSAX2GetParameterEntity</a>()</p></div><p>
Get a parameter entity by name
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the xmlEntityPtr if found.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="resolveEntity"></a>resolveEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> resolveEntity (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlEntityPtr if found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="resolveEntity"></a>resolveEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> resolveEntity (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *publicId,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId);</pre><p>
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>resolveEntity</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2ResolveEntity">xmlSAX2ResolveEntity</a>()</p></div><p>
The entity loader, to control the loading of external entities,
the application can either:
- override this <a href="libxml-SAX.html#resolveEntity">resolveEntity</a>() callback in the SAX block
- or better use the <a href="libxml-parser.html#xmlSetExternalEntityLoader">xmlSetExternalEntityLoader</a>() function to
set up it's own entity resolution routine</p><p>
set up it's own entity resolution routine
Returns</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i> :</span></td><td> The public ID of the entity
</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i> :</span></td><td> The system ID of the entity
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the xmlParserInputPtr if inlined or NULL for DOM behaviour.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="entityDecl"></a>entityDecl ()</h3><pre class="programlisting">void entityDecl (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i>:</span></td><td> The public ID of the entity
</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i>:</span></td><td> The system ID of the entity
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlParserInputPtr if inlined or NULL for DOM behaviour.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="entityDecl"></a>entityDecl ()</h3><pre class="programlisting">void entityDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *publicId,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId,
<a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
<a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>entityDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2EntityDecl">xmlSAX2EntityDecl</a>()</p></div><p>
An entity definition has been parsed</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the entity name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td> the entity type
</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i> :</span></td><td> The public ID of the entity
</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i> :</span></td><td> The system ID of the entity
</td></tr><tr><td><span class="term"><i><tt>content</tt></i> :</span></td><td> the entity value (without processing).
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="attributeDecl"></a>attributeDecl ()</h3><pre class="programlisting">void attributeDecl (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the entity type
</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i>:</span></td><td> The public ID of the entity
</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i>:</span></td><td> The system ID of the entity
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> the entity value (without processing).
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="attributeDecl"></a>attributeDecl ()</h3><pre class="programlisting">void attributeDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *fullname,
int type,
int def,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *defaultValue,
<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> tree);</pre><p>
<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> tree);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>attributeDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2AttributeDecl">xmlSAX2AttributeDecl</a>()</p></div><p>
An attribute definition has been parsed</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i> :</span></td><td> the name of the element
</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i> :</span></td><td> the attribute name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td> the attribute type
</td></tr><tr><td><span class="term"><i><tt>def</tt></i> :</span></td><td> the type of default value
</td></tr><tr><td><span class="term"><i><tt>defaultValue</tt></i> :</span></td><td> the attribute default value
</td></tr><tr><td><span class="term"><i><tt>tree</tt></i> :</span></td><td> the tree of enumerated value set
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="elementDecl"></a>elementDecl ()</h3><pre class="programlisting">void elementDecl (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the name of the element
</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i>:</span></td><td> the attribute name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the attribute type
</td></tr><tr><td><span class="term"><i><tt>def</tt></i>:</span></td><td> the type of default value
</td></tr><tr><td><span class="term"><i><tt>defaultValue</tt></i>:</span></td><td> the attribute default value
</td></tr><tr><td><span class="term"><i><tt>tree</tt></i>:</span></td><td> the tree of enumerated value set
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="elementDecl"></a>elementDecl ()</h3><pre class="programlisting">void elementDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int type,
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content);</pre><p>
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>elementDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2ElementDecl">xmlSAX2ElementDecl</a>()</p></div><p>
An element definition has been parsed</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the element name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td> the element type
</td></tr><tr><td><span class="term"><i><tt>content</tt></i> :</span></td><td> the element value tree
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="notationDecl"></a>notationDecl ()</h3><pre class="programlisting">void notationDecl (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the element name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the element type
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> the element value tree
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="notationDecl"></a>notationDecl ()</h3><pre class="programlisting">void notationDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *publicId,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId);</pre><p>
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>notationDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2NotationDecl">xmlSAX2NotationDecl</a>()</p></div><p>
What to do when a notation declaration has been parsed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The name of the notation
</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i> :</span></td><td> The public ID of the entity
</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i> :</span></td><td> The system ID of the entity
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="unparsedEntityDecl"></a>unparsedEntityDecl ()</h3><pre class="programlisting">void unparsedEntityDecl (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The name of the notation
</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i>:</span></td><td> The public ID of the entity
</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i>:</span></td><td> The system ID of the entity
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="unparsedEntityDecl"></a>unparsedEntityDecl ()</h3><pre class="programlisting">void unparsedEntityDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *publicId,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *systemId,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *notationName);</pre><p>
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *notationName);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>unparsedEntityDecl</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2UnparsedEntityDecl">xmlSAX2UnparsedEntityDecl</a>()</p></div><p>
What to do when an unparsed entity declaration is parsed</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The name of the entity
</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i> :</span></td><td> The public ID of the entity
</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i> :</span></td><td> The system ID of the entity
</td></tr><tr><td><span class="term"><i><tt>notationName</tt></i> :</span></td><td> the name of the notation
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="startDocument"></a>startDocument ()</h3><pre class="programlisting">void startDocument (void *ctx);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The name of the entity
</td></tr><tr><td><span class="term"><i><tt>publicId</tt></i>:</span></td><td> The public ID of the entity
</td></tr><tr><td><span class="term"><i><tt>systemId</tt></i>:</span></td><td> The system ID of the entity
</td></tr><tr><td><span class="term"><i><tt>notationName</tt></i>:</span></td><td> the name of the notation
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="startDocument"></a>startDocument ()</h3><pre class="programlisting">void startDocument (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>startDocument</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2StartDocument">xmlSAX2StartDocument</a>()</p></div><p>
called when the document start being processed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="endDocument"></a>endDocument ()</h3><pre class="programlisting">void endDocument (void *ctx);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="endDocument"></a>endDocument ()</h3><pre class="programlisting">void endDocument (void *ctx);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>endDocument</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2EndDocument">xmlSAX2EndDocument</a>()</p></div><p>
called when the document end has been detected.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="attribute"></a>attribute ()</h3><pre class="programlisting">void attribute (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="attribute"></a>attribute ()</h3><pre class="programlisting">void attribute (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *fullname,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>attribute</tt> is deprecated and should not be used in newly-written code. use <GTKDOCLINK HREF="xmlSAX2Attribute">xmlSAX2Attribute</GTKDOCLINK>()</p></div><p>
Handle an attribute that has been read by the parser.
The default handling is to convert the attribute into an
DOM subtree and past it in a new xmlAttr element added to
the element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i> :</span></td><td> The attribute name, including namespace prefix
</td></tr><tr><td><span class="term"><i><tt>value</tt></i> :</span></td><td> The attribute value
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="startElement"></a>startElement ()</h3><pre class="programlisting">void startElement (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i>:</span></td><td> The attribute name, including namespace prefix
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> The attribute value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="startElement"></a>startElement ()</h3><pre class="programlisting">void startElement (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *fullname,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> **atts);</pre><p>
const <a href="libxml-tree.html#xmlChar">xmlChar</a> **atts);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>startElement</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2StartElement">xmlSAX2StartElement</a>()</p></div><p>
called when an opening tag has been processed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i> :</span></td><td> The element name, including namespace prefix
</td></tr><tr><td><span class="term"><i><tt>atts</tt></i> :</span></td><td> An array of name/value attributes pairs, NULL terminated
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="endElement"></a>endElement ()</h3><pre class="programlisting">void endElement (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>fullname</tt></i>:</span></td><td> The element name, including namespace prefix
</td></tr><tr><td><span class="term"><i><tt>atts</tt></i>:</span></td><td> An array of name/value attributes pairs, NULL terminated
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="endElement"></a>endElement ()</h3><pre class="programlisting">void endElement (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>endElement</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2EndElement">xmlSAX2EndElement</a>()</p></div><p>
called when the end of an element has been detected.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The element name
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="reference"></a>reference ()</h3><pre class="programlisting">void reference (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The element name
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="reference"></a>reference ()</h3><pre class="programlisting">void reference (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>reference</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2Reference">xmlSAX2Reference</a>()</p></div><p>
called when an entity reference is detected.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> The entity name
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="characters"></a>characters ()</h3><pre class="programlisting">void characters (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> The entity name
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="characters"></a>characters ()</h3><pre class="programlisting">void characters (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ch,
int len);</pre><p>
int len);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>characters</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2Characters">xmlSAX2Characters</a>()</p></div><p>
receiving some chars from the parser.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>ch</tt></i> :</span></td><td> a xmlChar string
</td></tr><tr><td><span class="term"><i><tt>len</tt></i> :</span></td><td> the number of xmlChar
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="ignorableWhitespace"></a>ignorableWhitespace ()</h3><pre class="programlisting">void ignorableWhitespace (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> a xmlChar string
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the number of xmlChar
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="ignorableWhitespace"></a>ignorableWhitespace ()</h3><pre class="programlisting">void ignorableWhitespace (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ch,
int len);</pre><p>
int len);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>ignorableWhitespace</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2IgnorableWhitespace">xmlSAX2IgnorableWhitespace</a>()</p></div><p>
receiving some ignorable whitespaces from the parser.
UNUSED: by default the DOM building will use characters</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>ch</tt></i> :</span></td><td> a xmlChar string
</td></tr><tr><td><span class="term"><i><tt>len</tt></i> :</span></td><td> the number of xmlChar
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="processingInstruction"></a>processingInstruction ()</h3><pre class="programlisting">void processingInstruction (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> a xmlChar string
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the number of xmlChar
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="processingInstruction"></a>processingInstruction ()</h3><pre class="programlisting">void processingInstruction (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *data);</pre><p>
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *data);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>processingInstruction</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2ProcessingInstruction">xmlSAX2ProcessingInstruction</a>()</p></div><p>
A processing instruction has been parsed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>target</tt></i> :</span></td><td> the target name
</td></tr><tr><td><span class="term"><i><tt>data</tt></i> :</span></td><td> the PI data's
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="globalNamespace"></a>globalNamespace ()</h3><pre class="programlisting">void globalNamespace (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>target</tt></i>:</span></td><td> the target name
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> the PI data's
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="globalNamespace"></a>globalNamespace ()</h3><pre class="programlisting">void globalNamespace (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *href,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);</pre><p>
An old global namespace has been parsed.</p><p>
An old global namespace has been parsed.
DEPRECATED</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>href</tt></i> :</span></td><td> the namespace associated URN
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i> :</span></td><td> the namespace prefix
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="setNamespace"></a>setNamespace ()</h3><pre class="programlisting">void setNamespace (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>href</tt></i>:</span></td><td> the namespace associated URN
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the namespace prefix
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="setNamespace"></a>setNamespace ()</h3><pre class="programlisting">void setNamespace (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Set the current element namespace.</p><p>
Set the current element namespace.
DEPRECATED</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the namespace prefix
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="getNamespace"></a>getNamespace ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> getNamespace (void *ctx);</pre><p>
Get the current element namespace.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the namespace prefix
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="getNamespace"></a>getNamespace ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> getNamespace (void *ctx);</pre><p>
Get the current element namespace.
DEPRECATED</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the xmlNsPtr or NULL if none
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="checkNamespace"></a>checkNamespace ()</h3><pre class="programlisting">int checkNamespace (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlNsPtr or NULL if none
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="checkNamespace"></a>checkNamespace ()</h3><pre class="programlisting">int checkNamespace (void *ctx,
<a href="libxml-tree.html#xmlChar">xmlChar</a> *nameSpace);</pre><p>
Check that the current element namespace is the same as the
one read upon parsing.</p><p>
one read upon parsing.
DEPRECATED</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>nameSpace</tt></i> :</span></td><td> the namespace to check against
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>1 if true 0 otherwise
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="namespaceDecl"></a>namespaceDecl ()</h3><pre class="programlisting">void namespaceDecl (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>nameSpace</tt></i>:</span></td><td> the namespace to check against
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="namespaceDecl"></a>namespaceDecl ()</h3><pre class="programlisting">void namespaceDecl (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *href,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);</pre><p>
A namespace has been parsed.</p><p>
A namespace has been parsed.
DEPRECATED</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>href</tt></i> :</span></td><td> the namespace associated URN
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i> :</span></td><td> the namespace prefix
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="comment"></a>comment ()</h3><pre class="programlisting">void comment (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>href</tt></i>:</span></td><td> the namespace associated URN
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the namespace prefix
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="comment"></a>comment ()</h3><pre class="programlisting">void comment (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>comment</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2Comment">xmlSAX2Comment</a>()</p></div><p>
A comment has been parsed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>value</tt></i> :</span></td><td> the comment content
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="cdataBlock"></a>cdataBlock ()</h3><pre class="programlisting">void cdataBlock (void *ctx,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the comment content
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="cdataBlock"></a>cdataBlock ()</h3><pre class="programlisting">void cdataBlock (void *ctx,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
int len);</pre><p>
int len);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>cdataBlock</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2CDataBlock">xmlSAX2CDataBlock</a>()</p></div><p>
called when a pcdata block has been parsed</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>value</tt></i> :</span></td><td> The pcdata content
</td></tr><tr><td><span class="term"><i><tt>len</tt></i> :</span></td><td> the block length
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="initxmlDefaultSAXHandler"></a>initxmlDefaultSAXHandler ()</h3><pre class="programlisting">void initxmlDefaultSAXHandler (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr,
int warning);</pre><p>
Initialize the default XML SAX handler</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the user data (XML parser context)
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> The pcdata content
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the block length
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="initxmlDefaultSAXHandler"></a>initxmlDefaultSAXHandler ()</h3><pre class="programlisting">void initxmlDefaultSAXHandler (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr,
int warning);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>initxmlDefaultSAXHandler</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2InitDefaultSAXHandler">xmlSAX2InitDefaultSAXHandler</a>() for the new SAX2 blocks</p></div><p>
Initialize the default XML SAX version 1 handler</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>hdlr</tt></i> :</span></td><td> the SAX handler
</td></tr><tr><td><span class="term"><i><tt>warning</tt></i> :</span></td><td> flag if non-zero sets the handler warning procedure
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="inithtmlDefaultSAXHandler"></a>inithtmlDefaultSAXHandler ()</h3><pre class="programlisting">void inithtmlDefaultSAXHandler (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr);</pre><p>
Initialize the default HTML SAX handler</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>hdlr</tt></i>:</span></td><td> the SAX handler
</td></tr><tr><td><span class="term"><i><tt>warning</tt></i>:</span></td><td> flag if non-zero sets the handler warning procedure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="inithtmlDefaultSAXHandler"></a>inithtmlDefaultSAXHandler ()</h3><pre class="programlisting">void inithtmlDefaultSAXHandler (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>inithtmlDefaultSAXHandler</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2InitHtmlDefaultSAXHandler">xmlSAX2InitHtmlDefaultSAXHandler</a>() for the new SAX2 blocks</p></div><p>
Initialize the default HTML SAX version 1 handler</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>hdlr</tt></i> :</span></td><td> the SAX handler
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="initdocbDefaultSAXHandler"></a>initdocbDefaultSAXHandler ()</h3><pre class="programlisting">void initdocbDefaultSAXHandler (<a href="libxml-parser.html#xmlSAXHandler">xmlSAXHandler</a> *hdlr);</pre><p>
Initialize the default DocBook SAX handler</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>hdlr</tt></i>:</span></td><td> the SAX handler
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="initdocbDefaultSAXHandler"></a>initdocbDefaultSAXHandler ()</h3><pre class="programlisting">void initdocbDefaultSAXHandler (<a href="libxml-parser.html#xmlSAXHandlerV1">xmlSAXHandlerV1</a> *hdlr);</pre><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p><tt>initdocbDefaultSAXHandler</tt> is deprecated and should not be used in newly-written code. use <a href="libxml-SAX2.html#xmlSAX2InitDocbDefaultSAXHandler">xmlSAX2InitDocbDefaultSAXHandler</a>() for the new SAX2 blocks</p></div><p>
Initialize the default DocBook SAX version 1 handler</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>hdlr</tt></i> :</span></td><td> the SAX handler
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlDefaultSAXHandlerInit"></a>xmlDefaultSAXHandlerInit ()</h3><pre class="programlisting">void xmlDefaultSAXHandlerInit (void);</pre><p>
Initialize the default SAX handler</p><p>
</p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="htmlDefaultSAXHandlerInit"></a>htmlDefaultSAXHandlerInit ()</h3><pre class="programlisting">void htmlDefaultSAXHandlerInit (void);</pre><p>
Initialize the default SAX handler</p><p>
</p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="docbDefaultSAXHandlerInit"></a>docbDefaultSAXHandlerInit ()</h3><pre class="programlisting">void docbDefaultSAXHandlerInit (void);</pre><p>
Initialize the default SAX handler</p><p>
</p></div></div></div><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlreader.html"><b>&lt;&lt; xmlreader</b></a></td><td align="right"><a accesskey="n" href="libxml-tree.html"><b>tree &gt;&gt;</b></a></td></tr></table></body></html>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>hdlr</tt></i>:</span></td><td> the SAX handler
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xpath.html"><b>&lt;&lt; xpath</b></a></td><td align="right"><a accesskey="n" href="libxml-chvalid.html"><b>chvalid &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,16 +28,117 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-parser.html" title="parser"><link rel="next" href="libxml-xmlerror.html" title="xmlerror"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-parser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlerror.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-c14n"></a><div class="titlepage"></div><div class="refnamediv"><h2>c14n</h2><p>c14n &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2611851"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-parser.html" title="parser"><link rel="next" href="libxml-xmlerror.html" title="xmlerror"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-parser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlerror.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-c14n"></a><div class="titlepage"></div><div class="refnamediv"><h2>c14n</h2><p>c14n &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2676932"></a>Synopsis</h1></h2><pre class="synopsis">
int <a href="libxml-c14n.html#xmlC14NDocSaveTo">xmlC14NDocSaveTo</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> nodes,
int exclusive,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **inclusive_ns_prefixes,
int with_comments,
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf);
int <a href="libxml-c14n.html#xmlC14NDocDumpMemory">xmlC14NDocDumpMemory</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> nodes,
int exclusive,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **inclusive_ns_prefixes,
int with_comments,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **doc_txt_ptr);
int <a href="libxml-c14n.html#xmlC14NDocSave">xmlC14NDocSave</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> nodes,
int exclusive,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **inclusive_ns_prefixes,
int with_comments,
const char *filename,
int compression);
int (<a href="libxml-c14n.html#xmlC14NIsVisibleCallback">*xmlC14NIsVisibleCallback</a>) (void *user_data,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> parent);
int <a href="libxml-c14n.html#xmlC14NExecute">xmlC14NExecute</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-c14n.html#xmlC14NIsVisibleCallback">xmlC14NIsVisibleCallback</a> is_visible_callback,
void *user_data,
int exclusive,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **inclusive_ns_prefixes,
int with_comments,
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlC14NIsVisibleCallback"></a>xmlC14NIsVisibleCallback ()</h3><pre class="programlisting">int (*xmlC14NIsVisibleCallback) (void *user_data,
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlC14NDocSaveTo"></a>xmlC14NDocSaveTo ()</h3><pre class="programlisting">int xmlC14NDocSaveTo (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> nodes,
int exclusive,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **inclusive_ns_prefixes,
int with_comments,
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf);</pre><p>
Dumps the canonized image of given XML document into the provided buffer.
For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or
"Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n)</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the XML document for canonization
</td></tr><tr><td><span class="term"><i><tt>nodes</tt></i>:</span></td><td> the nodes set to be included in the canonized image
or NULL if all document nodes should be included
</td></tr><tr><td><span class="term"><i><tt>exclusive</tt></i>:</span></td><td> the exclusive flag (0 - non-exclusive canonicalization;
otherwise - exclusive canonicalization)
</td></tr><tr><td><span class="term"><i><tt>inclusive_ns_prefixes</tt></i>:</span></td><td> the list of inclusive namespace prefixes
ended with a NULL or NULL if there is no
inclusive namespaces (only for exclusive
canonicalization, ignored otherwise)
</td></tr><tr><td><span class="term"><i><tt>with_comments</tt></i>:</span></td><td> include comments in the result (!=0) or not (==0)
</td></tr><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the output buffer to store canonical XML; this
buffer MUST have encoder==NULL because C14N requires
UTF-8 output
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>non-negative value on success or a negative value on fail
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlC14NDocDumpMemory"></a>xmlC14NDocDumpMemory ()</h3><pre class="programlisting">int xmlC14NDocDumpMemory (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> nodes,
int exclusive,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **inclusive_ns_prefixes,
int with_comments,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **doc_txt_ptr);</pre><p>
Dumps the canonized image of given XML document into memory.
For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or
"Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n)</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the XML document for canonization
</td></tr><tr><td><span class="term"><i><tt>nodes</tt></i>:</span></td><td> the nodes set to be included in the canonized image
or NULL if all document nodes should be included
</td></tr><tr><td><span class="term"><i><tt>exclusive</tt></i>:</span></td><td> the exclusive flag (0 - non-exclusive canonicalization;
otherwise - exclusive canonicalization)
</td></tr><tr><td><span class="term"><i><tt>inclusive_ns_prefixes</tt></i>:</span></td><td> the list of inclusive namespace prefixes
ended with a NULL or NULL if there is no
inclusive namespaces (only for exclusive
canonicalization, ignored otherwise)
</td></tr><tr><td><span class="term"><i><tt>with_comments</tt></i>:</span></td><td> include comments in the result (!=0) or not (==0)
</td></tr><tr><td><span class="term"><i><tt>doc_txt_ptr</tt></i>:</span></td><td> the memory pointer for allocated canonical XML text;
the caller of this functions is responsible for calling
<a href="libxml-globals.html#xmlFree">xmlFree</a>() to free allocated memory
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of bytes written on success or a negative value on fail
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlC14NDocSave"></a>xmlC14NDocSave ()</h3><pre class="programlisting">int xmlC14NDocSave (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> nodes,
int exclusive,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **inclusive_ns_prefixes,
int with_comments,
const char *filename,
int compression);</pre><p>
Dumps the canonized image of given XML document into the file.
For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or
"Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n)</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the XML document for canonization
</td></tr><tr><td><span class="term"><i><tt>nodes</tt></i>:</span></td><td> the nodes set to be included in the canonized image
or NULL if all document nodes should be included
</td></tr><tr><td><span class="term"><i><tt>exclusive</tt></i>:</span></td><td> the exclusive flag (0 - non-exclusive canonicalization;
otherwise - exclusive canonicalization)
</td></tr><tr><td><span class="term"><i><tt>inclusive_ns_prefixes</tt></i>:</span></td><td> the list of inclusive namespace prefixes
ended with a NULL or NULL if there is no
inclusive namespaces (only for exclusive
canonicalization, ignored otherwise)
</td></tr><tr><td><span class="term"><i><tt>with_comments</tt></i>:</span></td><td> include comments in the result (!=0) or not (==0)
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename to store canonical XML image
</td></tr><tr><td><span class="term"><i><tt>compression</tt></i>:</span></td><td> the compression level (zlib requred):
-1 - libxml default,
0 - uncompressed,
&gt;0 - compression level
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of bytes written success or a negative value on fail
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlC14NIsVisibleCallback"></a>xmlC14NIsVisibleCallback ()</h3><pre class="programlisting">int (*xmlC14NIsVisibleCallback) (void *user_data,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> parent);</pre><p>
@ -47,4 +148,31 @@ int (<a href="libxml-c14n.html#xmlC14NIsVisibleCallback">*xmlC14NIsVisib
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlC14NExecute"></a>xmlC14NExecute ()</h3><pre class="programlisting">int xmlC14NExecute (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-c14n.html#xmlC14NIsVisibleCallback">xmlC14NIsVisibleCallback</a> is_visible_callback,
void *user_data,
int exclusive,
<a href="libxml-tree.html#xmlChar">xmlChar</a> **inclusive_ns_prefixes,
int with_comments,
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf);</pre><p>
Dumps the canonized image of given XML document into the provided buffer.
For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or
"Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n)</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the XML document for canonization
</td></tr><tr><td><span class="term"><i><tt>is_visible_callback</tt></i>:</span></td><td>the function to use to determine is node visible
or not
</td></tr><tr><td><span class="term"><i><tt>user_data</tt></i>:</span></td><td> the first parameter for <i><tt>is_visible_callback</tt></i> function
(in most cases, it is nodes set)
</td></tr><tr><td><span class="term"><i><tt>exclusive</tt></i>:</span></td><td> the exclusive flag (0 - non-exclusive canonicalization;
otherwise - exclusive canonicalization)
</td></tr><tr><td><span class="term"><i><tt>inclusive_ns_prefixes</tt></i>:</span></td><td> the list of inclusive namespace prefixes
ended with a NULL or NULL if there is no
inclusive namespaces (only for exclusive
canonicalization, ignored otherwise)
</td></tr><tr><td><span class="term"><i><tt>with_comments</tt></i>:</span></td><td> include comments in the result (!=0) or not (==0)
</td></tr><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the output buffer to store canonical XML; this
buffer MUST have encoder==NULL because C14N requires
UTF-8 output
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>non-negative value on success or a negative value on fail
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-parser.html"><b>&lt;&lt; parser</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlerror.html"><b>xmlerror &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-valid.html" title="valid"><link rel="next" href="libxml-tree.html" title="tree"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-valid.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-tree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-catalog"></a><div class="titlepage"></div><div class="refnamediv"><h2>catalog</h2><p>catalog &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2626461"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-valid.html" title="valid"><link rel="next" href="libxml-tree.html" title="tree"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-valid.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-tree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-catalog"></a><div class="titlepage"></div><div class="refnamediv"><h2>catalog</h2><p>catalog &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2826948"></a>Synopsis</h1></h2><pre class="synopsis">
@ -38,6 +38,59 @@ enum <a href="libxml-catalog.html#xmlCatalogPrefer">xmlCatalogPrefer</a>;
enum <a href="libxml-catalog.html#xmlCatalogAllow">xmlCatalogAllow</a>;
struct <a href="libxml-catalog.html#xmlCatalog">xmlCatalog</a>;
typedef <a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a>;
<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> <a href="libxml-catalog.html#xmlNewCatalog">xmlNewCatalog</a> (int sgml);
<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> <a href="libxml-catalog.html#xmlLoadACatalog">xmlLoadACatalog</a> (const char *filename);
<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> <a href="libxml-catalog.html#xmlLoadSGMLSuperCatalog">xmlLoadSGMLSuperCatalog</a> (const char *filename);
int <a href="libxml-catalog.html#xmlConvertSGMLCatalog">xmlConvertSGMLCatalog</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal);
int <a href="libxml-catalog.html#xmlACatalogAdd">xmlACatalogAdd</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *orig,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *replace);
int <a href="libxml-catalog.html#xmlACatalogRemove">xmlACatalogRemove</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlACatalogResolve">xmlACatalogResolve</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlACatalogResolveSystem">xmlACatalogResolveSystem</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlACatalogResolvePublic">xmlACatalogResolvePublic</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlACatalogResolveURI">xmlACatalogResolveURI</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI);
void <a href="libxml-catalog.html#xmlACatalogDump">xmlACatalogDump</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out);
void <a href="libxml-catalog.html#xmlFreeCatalog">xmlFreeCatalog</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal);
int <a href="libxml-catalog.html#xmlCatalogIsEmpty">xmlCatalogIsEmpty</a> (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal);
void <a href="libxml-catalog.html#xmlInitializeCatalog">xmlInitializeCatalog</a> (void);
int <a href="libxml-catalog.html#xmlLoadCatalog">xmlLoadCatalog</a> (const char *filename);
void <a href="libxml-catalog.html#xmlLoadCatalogs">xmlLoadCatalogs</a> (const char *paths);
void <a href="libxml-catalog.html#xmlCatalogCleanup">xmlCatalogCleanup</a> (void);
void <a href="libxml-catalog.html#xmlCatalogDump">xmlCatalogDump</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlCatalogResolve">xmlCatalogResolve</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlCatalogResolveSystem">xmlCatalogResolveSystem</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlCatalogResolvePublic">xmlCatalogResolvePublic</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlCatalogResolveURI">xmlCatalogResolveURI</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI);
int <a href="libxml-catalog.html#xmlCatalogAdd">xmlCatalogAdd</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *orig,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *replace);
int <a href="libxml-catalog.html#xmlCatalogRemove">xmlCatalogRemove</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> <a href="libxml-catalog.html#xmlParseCatalogFile">xmlParseCatalogFile</a> (const char *filename);
int <a href="libxml-catalog.html#xmlCatalogConvert">xmlCatalogConvert</a> (void);
void <a href="libxml-catalog.html#xmlCatalogFreeLocal">xmlCatalogFreeLocal</a> (void *catalogs);
void* <a href="libxml-catalog.html#xmlCatalogAddLocal">xmlCatalogAddLocal</a> (void *catalogs,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URL);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlCatalogLocalResolve">xmlCatalogLocalResolve</a> (void *catalogs,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlCatalogLocalResolveURI">xmlCatalogLocalResolveURI</a> (void *catalogs,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI);
int <a href="libxml-catalog.html#xmlCatalogSetDebug">xmlCatalogSetDebug</a> (int level);
<a href="libxml-catalog.html#xmlCatalogPrefer">xmlCatalogPrefer</a> <a href="libxml-catalog.html#xmlCatalogSetDefaultPrefer">xmlCatalogSetDefaultPrefer</a> (<a href="libxml-catalog.html#xmlCatalogPrefer">xmlCatalogPrefer</a> prefer);
void <a href="libxml-catalog.html#xmlCatalogSetDefaults">xmlCatalogSetDefaults</a> (<a href="libxml-catalog.html#xmlCatalogAllow">xmlCatalogAllow</a> allow);
<a href="libxml-catalog.html#xmlCatalogAllow">xmlCatalogAllow</a> <a href="libxml-catalog.html#xmlCatalogGetDefaults">xmlCatalogGetDefaults</a> (void);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlCatalogGetSystem">xmlCatalogGetSystem</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-catalog.html#xmlCatalogGetPublic">xmlCatalogGetPublic</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="XML-CATALOGS-NAMESPACE-CAPS"></a>XML_CATALOGS_NAMESPACE</h3><pre class="programlisting">#define XML_CATALOGS_NAMESPACE</pre><p>
@ -66,4 +119,244 @@ The specific XML Catalog Processing Instuction name.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlCatalogPtr"></a>xmlCatalogPtr</h3><pre class="programlisting">typedef xmlCatalog *xmlCatalogPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-valid.html"><b>&lt;&lt; valid</b></a></td><td align="right"><a accesskey="n" href="libxml-tree.html"><b>tree &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlNewCatalog"></a>xmlNewCatalog ()</h3><pre class="programlisting"><a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> xmlNewCatalog (int sgml);</pre><p>
create a new Catalog.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>sgml</tt></i>:</span></td><td> should this create an SGML catalog
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlCatalogPtr or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlLoadACatalog"></a>xmlLoadACatalog ()</h3><pre class="programlisting"><a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> xmlLoadACatalog (const char *filename);</pre><p>
Load the catalog and build the associated data structures.
This can be either an XML Catalog or an SGML Catalog
It will recurse in SGML CATALOG entries. On the other hand XML
Catalogs are not handled recursively.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> a file path
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the catalog parsed or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlLoadSGMLSuperCatalog"></a>xmlLoadSGMLSuperCatalog ()</h3><pre class="programlisting"><a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> xmlLoadSGMLSuperCatalog (const char *filename);</pre><p>
Load an SGML super catalog. It won't expand CATALOG or DELEGATE
references. This is only needed for manipulating SGML Super Catalogs
like adding and removing CATALOG or DELEGATE entries.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> a file path
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the catalog parsed or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlConvertSGMLCatalog"></a>xmlConvertSGMLCatalog ()</h3><pre class="programlisting">int xmlConvertSGMLCatalog (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal);</pre><p>
Convert all the SGML catalog entries as XML ones</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> the catalog
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of entries converted if successful, -1 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlACatalogAdd"></a>xmlACatalogAdd ()</h3><pre class="programlisting">int xmlACatalogAdd (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *orig,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *replace);</pre><p>
Add an entry in the catalog, it may overwrite existing but
different entries.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> a Catalog
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the type of record to add to the catalog
</td></tr><tr><td><span class="term"><i><tt>orig</tt></i>:</span></td><td> the system, public or prefix to match
</td></tr><tr><td><span class="term"><i><tt>replace</tt></i>:</span></td><td> the replacement value for the match
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if successful, -1 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlACatalogRemove"></a>xmlACatalogRemove ()</h3><pre class="programlisting">int xmlACatalogRemove (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Remove an entry from the catalog</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> a Catalog
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the value to remove
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of entries removed if successful, -1 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlACatalogResolve"></a>xmlACatalogResolve ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlACatalogResolve (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);</pre><p>
Do a complete resolution lookup of an External Identifier</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> a Catalog
</td></tr><tr><td><span class="term"><i><tt>pubID</tt></i>:</span></td><td> the public ID string
</td></tr><tr><td><span class="term"><i><tt>sysID</tt></i>:</span></td><td> the system ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the URI of the resource or NULL if not found, it must be freed
by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlACatalogResolveSystem"></a>xmlACatalogResolveSystem ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlACatalogResolveSystem (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);</pre><p>
Try to lookup the catalog resource for a system ID</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> a Catalog
</td></tr><tr><td><span class="term"><i><tt>sysID</tt></i>:</span></td><td> the public ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the system ID if found or NULL otherwise, the value returned
must be freed by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlACatalogResolvePublic"></a>xmlACatalogResolvePublic ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlACatalogResolvePublic (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID);</pre><p>
Try to lookup the system ID associated to a public ID in that catalog</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> a Catalog
</td></tr><tr><td><span class="term"><i><tt>pubID</tt></i>:</span></td><td> the public ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the system ID if found or NULL otherwise, the value returned
must be freed by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlACatalogResolveURI"></a>xmlACatalogResolveURI ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlACatalogResolveURI (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI);</pre><p>
Do a complete resolution lookup of an URI</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> a Catalog
</td></tr><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> the URI
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the URI of the resource or NULL if not found, it must be freed
by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlACatalogDump"></a>xmlACatalogDump ()</h3><pre class="programlisting">void xmlACatalogDump (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal,
<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out);</pre><p>
Free up all the memory associated with catalogs</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> a Catalog
</td></tr><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> the file.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeCatalog"></a>xmlFreeCatalog ()</h3><pre class="programlisting">void xmlFreeCatalog (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal);</pre><p>
Free the memory allocated to a Catalog</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> a Catalog entry
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogIsEmpty"></a>xmlCatalogIsEmpty ()</h3><pre class="programlisting">int xmlCatalogIsEmpty (<a href="libxml-catalog.html#xmlCatalogPtr">xmlCatalogPtr</a> catal);</pre><p>
Check is a catalog is empty</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catal</tt></i>:</span></td><td> should this create an SGML catalog
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if the catalog is empty, 0 if not, amd -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlInitializeCatalog"></a>xmlInitializeCatalog ()</h3><pre class="programlisting">void xmlInitializeCatalog (void);</pre><p>
Do the catalog initialization.
this function is not thread safe, catalog initialization should
preferably be done once at startup</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlLoadCatalog"></a>xmlLoadCatalog ()</h3><pre class="programlisting">int xmlLoadCatalog (const char *filename);</pre><p>
Load the catalog and makes its definitions effective for the default
external entity loader. It will recurse in SGML CATALOG entries.
this function is not thread safe, catalog initialization should
preferably be done once at startup</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> a file path
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlLoadCatalogs"></a>xmlLoadCatalogs ()</h3><pre class="programlisting">void xmlLoadCatalogs (const char *paths);</pre><p>
Load the catalogs and makes their definitions effective for the default
external entity loader.
this function is not thread safe, catalog initialization should
preferably be done once at startup</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>paths</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogCleanup"></a>xmlCatalogCleanup ()</h3><pre class="programlisting">void xmlCatalogCleanup (void);</pre><p>
Free up all the memory associated with catalogs</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlCatalogDump"></a>xmlCatalogDump ()</h3><pre class="programlisting">void xmlCatalogDump (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *out);</pre><p>
Free up all the memory associated with catalogs</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> the file.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogResolve"></a>xmlCatalogResolve ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCatalogResolve (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);</pre><p>
Do a complete resolution lookup of an External Identifier</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>pubID</tt></i>:</span></td><td> the public ID string
</td></tr><tr><td><span class="term"><i><tt>sysID</tt></i>:</span></td><td> the system ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the URI of the resource or NULL if not found, it must be freed
by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogResolveSystem"></a>xmlCatalogResolveSystem ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCatalogResolveSystem (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);</pre><p>
Try to lookup the catalog resource for a system ID</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>sysID</tt></i>:</span></td><td> the public ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the system ID if found or NULL otherwise, the value returned
must be freed by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogResolvePublic"></a>xmlCatalogResolvePublic ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCatalogResolvePublic (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID);</pre><p>
Try to lookup the system ID associated to a public ID</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>pubID</tt></i>:</span></td><td> the public ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the system ID if found or NULL otherwise, the value returned
must be freed by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogResolveURI"></a>xmlCatalogResolveURI ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCatalogResolveURI (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI);</pre><p>
Do a complete resolution lookup of an URI</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> the URI
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the URI of the resource or NULL if not found, it must be freed
by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogAdd"></a>xmlCatalogAdd ()</h3><pre class="programlisting">int xmlCatalogAdd (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *orig,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *replace);</pre><p>
Add an entry in the catalog, it may overwrite existing but
different entries.
If called before any other catalog routine, allows to override the
default shared catalog put in place by <a href="libxml-catalog.html#xmlInitializeCatalog">xmlInitializeCatalog</a>();</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the type of record to add to the catalog
</td></tr><tr><td><span class="term"><i><tt>orig</tt></i>:</span></td><td> the system, public or prefix to match
</td></tr><tr><td><span class="term"><i><tt>replace</tt></i>:</span></td><td> the replacement value for the match
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if successful, -1 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogRemove"></a>xmlCatalogRemove ()</h3><pre class="programlisting">int xmlCatalogRemove (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Remove an entry from the catalog</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the value to remove
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of entries removed if successful, -1 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParseCatalogFile"></a>xmlParseCatalogFile ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlParseCatalogFile (const char *filename);</pre><p>
parse an XML file and build a tree. It's like <a href="libxml-parser.html#xmlParseFile">xmlParseFile</a>()
except it bypass all catalog lookups.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the resulting document tree or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogConvert"></a>xmlCatalogConvert ()</h3><pre class="programlisting">int xmlCatalogConvert (void);</pre><p>
Convert all the SGML catalog entries as XML ones</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of entries converted if successful, -1 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogFreeLocal"></a>xmlCatalogFreeLocal ()</h3><pre class="programlisting">void xmlCatalogFreeLocal (void *catalogs);</pre><p>
Free up the memory associated to the catalog list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catalogs</tt></i>:</span></td><td> a document's list of catalogs
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogAddLocal"></a>xmlCatalogAddLocal ()</h3><pre class="programlisting">void* xmlCatalogAddLocal (void *catalogs,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URL);</pre><p>
Add the new entry to the catalog list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catalogs</tt></i>:</span></td><td> a document's list of catalogs
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the URL to a new local catalog
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogLocalResolve"></a>xmlCatalogLocalResolve ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCatalogLocalResolve (void *catalogs,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);</pre><p>
Do a complete resolution lookup of an External Identifier using a
document's private catalog list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catalogs</tt></i>:</span></td><td> a document's list of catalogs
</td></tr><tr><td><span class="term"><i><tt>pubID</tt></i>:</span></td><td> the public ID string
</td></tr><tr><td><span class="term"><i><tt>sysID</tt></i>:</span></td><td> the system ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the URI of the resource or NULL if not found, it must be freed
by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogLocalResolveURI"></a>xmlCatalogLocalResolveURI ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCatalogLocalResolveURI (void *catalogs,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI);</pre><p>
Do a complete resolution lookup of an URI using a
document's private catalog list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>catalogs</tt></i>:</span></td><td> a document's list of catalogs
</td></tr><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> the URI
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the URI of the resource or NULL if not found, it must be freed
by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogSetDebug"></a>xmlCatalogSetDebug ()</h3><pre class="programlisting">int xmlCatalogSetDebug (int level);</pre><p>
Used to set the debug level for catalog operation, 0 disable
debugging, 1 enable it</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>level</tt></i>:</span></td><td> the debug level of catalogs required
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the previous value of the catalog debugging level
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogSetDefaultPrefer"></a>xmlCatalogSetDefaultPrefer ()</h3><pre class="programlisting"><a href="libxml-catalog.html#xmlCatalogPrefer">xmlCatalogPrefer</a> xmlCatalogSetDefaultPrefer (<a href="libxml-catalog.html#xmlCatalogPrefer">xmlCatalogPrefer</a> prefer);</pre><p>
Allows to set the preference between public and system for deletion
in XML Catalog resolution. C.f. section 4.1.1 of the spec
Values accepted are XML_CATA_PREFER_PUBLIC or XML_CATA_PREFER_SYSTEM</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>prefer</tt></i>:</span></td><td> the default preference for delegation
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the previous value of the default preference for delegation
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogSetDefaults"></a>xmlCatalogSetDefaults ()</h3><pre class="programlisting">void xmlCatalogSetDefaults (<a href="libxml-catalog.html#xmlCatalogAllow">xmlCatalogAllow</a> allow);</pre><p>
Used to set the user preference w.r.t. to what catalogs should
be accepted</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>allow</tt></i>:</span></td><td> what catalogs should be accepted
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogGetDefaults"></a>xmlCatalogGetDefaults ()</h3><pre class="programlisting"><a href="libxml-catalog.html#xmlCatalogAllow">xmlCatalogAllow</a> xmlCatalogGetDefaults (void);</pre><p>
Used to get the user preference w.r.t. to what catalogs should
be accepted</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the current xmlCatalogAllow value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogGetSystem"></a>xmlCatalogGetSystem ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCatalogGetSystem (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysID);</pre><p>
Try to lookup the system ID associated to a public ID
DEPRECATED, use <a href="libxml-catalog.html#xmlCatalogResolveSystem">xmlCatalogResolveSystem</a>()</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>sysID</tt></i>:</span></td><td> the system ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the system ID if found or NULL otherwise.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCatalogGetPublic"></a>xmlCatalogGetPublic ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCatalogGetPublic (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubID);</pre><p>
Try to lookup the system ID associated to a public ID
DEPRECATED, use <a href="libxml-catalog.html#xmlCatalogResolvePublic">xmlCatalogResolvePublic</a>()</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>pubID</tt></i>:</span></td><td> the public ID string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the system ID if found or NULL otherwise.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-valid.html"><b>&lt;&lt; valid</b></a></td><td align="right"><a accesskey="n" href="libxml-tree.html"><b>tree &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xpath.html" title="xpath"><link rel="next" href="libxml-uri.html" title="uri"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xpath.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-uri.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-chvalid"></a><div class="titlepage"></div><div class="refnamediv"><h2>chvalid</h2><p>chvalid &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2587244"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-SAX.html" title="SAX"><link rel="next" href="libxml-uri.html" title="uri"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-SAX.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-uri.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-chvalid"></a><div class="titlepage"></div><div class="refnamediv"><h2>chvalid</h2><p>chvalid &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2654349"></a>Synopsis</h1></h2><pre class="synopsis">
@ -38,6 +38,8 @@ struct <a href="libxml-chvalid.html#xmlChLRange">xmlChLRange</a>;
typedef <a href="libxml-chvalid.html#xmlChLRangePtr">xmlChLRangePtr</a>;
struct <a href="libxml-chvalid.html#xmlChRangeGroup">xmlChRangeGroup</a>;
typedef <a href="libxml-chvalid.html#xmlChRangeGroupPtr">xmlChRangeGroupPtr</a>;
int <a href="libxml-chvalid.html#xmlCharInRange">xmlCharInRange</a> (unsigned int val,
const <a href="libxml-chvalid.html#xmlChRangeGroupPtr">xmlChRangeGroupPtr</a> group);
#define <a href="libxml-chvalid.html#xmlIsBaseChar-ch">xmlIsBaseChar_ch</a> (c)
#define <a href="libxml-chvalid.html#xmlIsBaseCharQ">xmlIsBaseCharQ</a> (c)
extern xmlChRangeGroup <a href="libxml-chvalid.html#xmlIsBaseCharGroup">xmlIsBaseCharGroup</a>;
@ -58,6 +60,14 @@ extern xmlChRangeGroup <a href="libxml-chvalid.html#xmlIsExtenderGroup">xml
extern xmlChRangeGroup <a href="libxml-chvalid.html#xmlIsIdeographicGroup">xmlIsIdeographicGroup</a>;
#define <a href="libxml-chvalid.html#xmlIsPubidChar-ch">xmlIsPubidChar_ch</a> (c)
#define <a href="libxml-chvalid.html#xmlIsPubidCharQ">xmlIsPubidCharQ</a> (c)
int <a href="libxml-chvalid.html#xmlIsBaseChar">xmlIsBaseChar</a> (unsigned int ch);
int <a href="libxml-chvalid.html#xmlIsBlank">xmlIsBlank</a> (unsigned int ch);
int <a href="libxml-chvalid.html#xmlIsChar">xmlIsChar</a> (unsigned int ch);
int <a href="libxml-chvalid.html#xmlIsCombining">xmlIsCombining</a> (unsigned int ch);
int <a href="libxml-chvalid.html#xmlIsDigit">xmlIsDigit</a> (unsigned int ch);
int <a href="libxml-chvalid.html#xmlIsExtender">xmlIsExtender</a> (unsigned int ch);
int <a href="libxml-chvalid.html#xmlIsIdeographic">xmlIsIdeographic</a> (unsigned int ch);
int <a href="libxml-chvalid.html#xmlIsPubidChar">xmlIsPubidChar</a> (unsigned int ch);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlChSRange"></a>struct xmlChSRange</h3><pre class="programlisting">struct xmlChSRange {
@ -92,7 +102,15 @@ extern xmlChRangeGroup <a href="libxml-chvalid.html#xmlIsIdeographicGroup">
</p></div><hr><div class="refsect2"><h3><a name="xmlChRangeGroupPtr"></a>xmlChRangeGroupPtr</h3><pre class="programlisting">typedef xmlChRangeGroup *xmlChRangeGroupPtr;
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlIsBaseChar-ch"></a>xmlIsBaseChar_ch()</h3><pre class="programlisting">#define xmlIsBaseChar_ch(c)</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlCharInRange"></a>xmlCharInRange ()</h3><pre class="programlisting">int xmlCharInRange (unsigned int val,
const <a href="libxml-chvalid.html#xmlChRangeGroupPtr">xmlChRangeGroupPtr</a> group);</pre><p>
Does a binary search of the range table to determine if char
is valid</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> character to be validated
</td></tr><tr><td><span class="term"><i><tt>group</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> true if character valid, false otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsBaseChar-ch"></a>xmlIsBaseChar_ch()</h3><pre class="programlisting">#define xmlIsBaseChar_ch(c)</pre><p>
Automatically generated by genChRanges.py</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>c</tt></i>:</span></td><td> char to validate
@ -169,4 +187,52 @@ Automatically generated by genChRanges.py</p><p>
Automatically generated by genChRanges.py</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>c</tt></i>:</span></td><td> char to validate
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xpath.html"><b>&lt;&lt; xpath</b></a></td><td align="right"><a accesskey="n" href="libxml-uri.html"><b>uri &gt;&gt;</b></a></td></tr></table></body></html>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsBaseChar"></a>xmlIsBaseChar ()</h3><pre class="programlisting">int xmlIsBaseChar (unsigned int ch);</pre><p>
This function is DEPRECATED. Use xmlIsBaseChar_ch
or xmlIsBaseCharQ instead</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> character to validate
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>true if argument valid, false otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsBlank"></a>xmlIsBlank ()</h3><pre class="programlisting">int xmlIsBlank (unsigned int ch);</pre><p>
This function is DEPRECATED. Use xmlIsBlank_ch
or xmlIsBlankQ instead</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> character to validate
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>true if argument valid, false otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsChar"></a>xmlIsChar ()</h3><pre class="programlisting">int xmlIsChar (unsigned int ch);</pre><p>
This function is DEPRECATED. Use xmlIsChar_ch
or xmlIsCharQ instead</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> character to validate
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>true if argument valid, false otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsCombining"></a>xmlIsCombining ()</h3><pre class="programlisting">int xmlIsCombining (unsigned int ch);</pre><p>
This function is DEPRECATED. Use xmlIsCombining_ch
or xmlIsCombiningQ instead</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> character to validate
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>true if argument valid, false otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsDigit"></a>xmlIsDigit ()</h3><pre class="programlisting">int xmlIsDigit (unsigned int ch);</pre><p>
This function is DEPRECATED. Use xmlIsDigit_ch
or xmlIsDigitQ instead</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> character to validate
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>true if argument valid, false otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsExtender"></a>xmlIsExtender ()</h3><pre class="programlisting">int xmlIsExtender (unsigned int ch);</pre><p>
This function is DEPRECATED. Use xmlIsExtender_ch
or xmlIsExtenderQ instead</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> character to validate
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>true if argument valid, false otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsIdeographic"></a>xmlIsIdeographic ()</h3><pre class="programlisting">int xmlIsIdeographic (unsigned int ch);</pre><p>
This function is DEPRECATED. Use xmlIsIdeographic_ch
or xmlIsIdeographicQ instead</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> character to validate
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>true if argument valid, false otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsPubidChar"></a>xmlIsPubidChar ()</h3><pre class="programlisting">int xmlIsPubidChar (unsigned int ch);</pre><p>
This function is DEPRECATED. Use xmlIsPubidChar_ch
or xmlIsPubidCharQ instead</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ch</tt></i>:</span></td><td> character to validate
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>true if argument valid, false otherwise
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-SAX.html"><b>&lt;&lt; SAX</b></a></td><td align="right"><a accesskey="n" href="libxml-uri.html"><b>uri &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,10 +28,39 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlreader.html" title="xmlreader"><link rel="next" href="libxml-xmlwriter.html" title="xmlwriter"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlreader.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlwriter.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-debugXML"></a><div class="titlepage"></div><div class="refnamediv"><h2>debugXML</h2><p>debugXML &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2590102"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlreader.html" title="xmlreader"><link rel="next" href="libxml-xmlwriter.html" title="xmlwriter"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlreader.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlwriter.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-debugXML"></a><div class="titlepage"></div><div class="refnamediv"><h2>debugXML</h2><p>debugXML &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2607966"></a>Synopsis</h1></h2><pre class="synopsis">
void <a href="libxml-debugXML.html#xmlDebugDumpString">xmlDebugDumpString</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);
void <a href="libxml-debugXML.html#xmlDebugDumpAttr">xmlDebugDumpAttr</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr,
int depth);
void <a href="libxml-debugXML.html#xmlDebugDumpAttrList">xmlDebugDumpAttrList</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr,
int depth);
void <a href="libxml-debugXML.html#xmlDebugDumpOneNode">xmlDebugDumpOneNode</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
int depth);
void <a href="libxml-debugXML.html#xmlDebugDumpNode">xmlDebugDumpNode</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
int depth);
void <a href="libxml-debugXML.html#xmlDebugDumpNodeList">xmlDebugDumpNodeList</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
int depth);
void <a href="libxml-debugXML.html#xmlDebugDumpDocumentHead">xmlDebugDumpDocumentHead</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
void <a href="libxml-debugXML.html#xmlDebugDumpDocument">xmlDebugDumpDocument</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
void <a href="libxml-debugXML.html#xmlDebugDumpDTD">xmlDebugDumpDTD</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd);
void <a href="libxml-debugXML.html#xmlDebugDumpEntities">xmlDebugDumpEntities</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
void <a href="libxml-debugXML.html#xmlLsOneNode">xmlLsOneNode</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);
int <a href="libxml-debugXML.html#xmlLsCountNode">xmlLsCountNode</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);
const char* <a href="libxml-debugXML.html#xmlBoolToText">xmlBoolToText</a> (int boolval);
char* (<a href="libxml-debugXML.html#xmlShellReadlineFunc">*xmlShellReadlineFunc</a>) (char *prompt);
struct <a href="libxml-debugXML.html#xmlShellCtxt">xmlShellCtxt</a>;
typedef <a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a>;
@ -39,9 +68,143 @@ int (<a href="libxml-debugXML.html#xmlShellCmd">*xmlShellCmd</a>)
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
void <a href="libxml-debugXML.html#xmlShellPrintXPathError">xmlShellPrintXPathError</a> (int errorType,
const char *arg);
void <a href="libxml-debugXML.html#xmlShellPrintNode">xmlShellPrintNode</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);
void <a href="libxml-debugXML.html#xmlShellPrintXPathResult">xmlShellPrintXPathResult</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> list);
int <a href="libxml-debugXML.html#xmlShellList">xmlShellList</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellBase">xmlShellBase</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellDir">xmlShellDir</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellCat">xmlShellCat</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellLoad">xmlShellLoad</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *filename,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellWrite">xmlShellWrite</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *filename,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellSave">xmlShellSave</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *filename,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellValidate">xmlShellValidate</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *dtd,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellDu">xmlShellDu</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> tree,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-debugXML.html#xmlShellPwd">xmlShellPwd</a> (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *buffer,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
void <a href="libxml-debugXML.html#xmlShell">xmlShell</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
char *filename,
<a href="libxml-debugXML.html#xmlShellReadlineFunc">xmlShellReadlineFunc</a> input,
<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlShellReadlineFunc"></a>xmlShellReadlineFunc ()</h3><pre class="programlisting">char* (*xmlShellReadlineFunc) (char *prompt);</pre><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlDebugDumpString"></a>xmlDebugDumpString ()</h3><pre class="programlisting">void xmlDebugDumpString (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);</pre><p>
Dumps informations about the string, shorten it if necessary</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the string
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpAttr"></a>xmlDebugDumpAttr ()</h3><pre class="programlisting">void xmlDebugDumpAttr (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr,
int depth);</pre><p>
Dumps debug information for the attribute</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> the attribute
</td></tr><tr><td><span class="term"><i><tt>depth</tt></i>:</span></td><td> the indentation level.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpAttrList"></a>xmlDebugDumpAttrList ()</h3><pre class="programlisting">void xmlDebugDumpAttrList (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr,
int depth);</pre><p>
Dumps debug information for the attribute list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> the attribute list
</td></tr><tr><td><span class="term"><i><tt>depth</tt></i>:</span></td><td> the indentation level.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpOneNode"></a>xmlDebugDumpOneNode ()</h3><pre class="programlisting">void xmlDebugDumpOneNode (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
int depth);</pre><p>
Dumps debug information for the element node, it is not recursive</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> the node
</td></tr><tr><td><span class="term"><i><tt>depth</tt></i>:</span></td><td> the indentation level.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpNode"></a>xmlDebugDumpNode ()</h3><pre class="programlisting">void xmlDebugDumpNode (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
int depth);</pre><p>
Dumps debug information for the element node, it is recursive</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> the node
</td></tr><tr><td><span class="term"><i><tt>depth</tt></i>:</span></td><td> the indentation level.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpNodeList"></a>xmlDebugDumpNodeList ()</h3><pre class="programlisting">void xmlDebugDumpNodeList (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
int depth);</pre><p>
Dumps debug information for the list of element node, it is recursive</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> the node list
</td></tr><tr><td><span class="term"><i><tt>depth</tt></i>:</span></td><td> the indentation level.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpDocumentHead"></a>xmlDebugDumpDocumentHead ()</h3><pre class="programlisting">void xmlDebugDumpDocumentHead (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Dumps debug information cncerning the document, not recursive</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpDocument"></a>xmlDebugDumpDocument ()</h3><pre class="programlisting">void xmlDebugDumpDocument (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Dumps debug information for the document, it's recursive</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpDTD"></a>xmlDebugDumpDTD ()</h3><pre class="programlisting">void xmlDebugDumpDTD (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd);</pre><p>
Dumps debug information for the DTD</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> the DTD
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDebugDumpEntities"></a>xmlDebugDumpEntities ()</h3><pre class="programlisting">void xmlDebugDumpEntities (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Dumps debug information for all the entities in use by the document</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlLsOneNode"></a>xmlLsOneNode ()</h3><pre class="programlisting">void xmlLsOneNode (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);</pre><p>
Dump to <i><tt>output</tt></i> the type and name of <i><tt>node</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the FILE * for the output
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> the node to dump
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlLsCountNode"></a>xmlLsCountNode ()</h3><pre class="programlisting">int xmlLsCountNode (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);</pre><p>
Count the children of <i><tt>node</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> the node to count
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of children of <i><tt>node</tt></i>.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlBoolToText"></a>xmlBoolToText ()</h3><pre class="programlisting">const char* xmlBoolToText (int boolval);</pre><p>
Convenient way to turn bool into text</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>boolval</tt></i>:</span></td><td> a bool to turn into text
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a pointer to either "True" or "False"
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellReadlineFunc"></a>xmlShellReadlineFunc ()</h3><pre class="programlisting">char* (*xmlShellReadlineFunc) (char *prompt);</pre><p>
This is a generic signature for the XML shell input function.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>prompt</tt></i>:</span></td><td> a string prompt
@ -74,4 +237,155 @@ This is a generic signature for the XML shell functions.</p><p>
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a first node
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> a second node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an int, negative returns indicating errors.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellPrintXPathError"></a>xmlShellPrintXPathError ()</h3><pre class="programlisting">void xmlShellPrintXPathError (int errorType,
const char *arg);</pre><p>
Print the xpath error to libxml default error channel</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>errorType</tt></i>:</span></td><td> valid xpath error id
</td></tr><tr><td><span class="term"><i><tt>arg</tt></i>:</span></td><td> the argument that cause xpath to fail
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellPrintNode"></a>xmlShellPrintNode ()</h3><pre class="programlisting">void xmlShellPrintNode (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);</pre><p>
Print node to the output FILE</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a non-null node to print to the output FILE
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellPrintXPathResult"></a>xmlShellPrintXPathResult ()</h3><pre class="programlisting">void xmlShellPrintXPathResult (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> list);</pre><p>
Prints result to the output FILE</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>list</tt></i>:</span></td><td> a valid result generated by an xpath evaluation
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellList"></a>xmlShellList ()</h3><pre class="programlisting">int xmlShellList (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "ls"
Does an Unix like listing of the given node (like a directory)</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>arg</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a node
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellBase"></a>xmlShellBase ()</h3><pre class="programlisting">int xmlShellBase (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "base"
dumps the current XML base of the node</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>arg</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a node
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellDir"></a>xmlShellDir ()</h3><pre class="programlisting">int xmlShellDir (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "dir"
dumps informations about the node (namespace, attributes, content).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>arg</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a node
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellCat"></a>xmlShellCat ()</h3><pre class="programlisting">int xmlShellCat (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "cat"
dumps the serialization node content (XML or HTML).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>arg</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a node
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellLoad"></a>xmlShellLoad ()</h3><pre class="programlisting">int xmlShellLoad (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *filename,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "load"
loads a new document specified by the filename</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the file name
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 if loading failed
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellWrite"></a>xmlShellWrite ()</h3><pre class="programlisting">int xmlShellWrite (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *filename,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "write"
Write the current node to the filename, it saves the serialization
of the subtree under the <i><tt>node</tt></i> specified</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the file name
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a node in the tree
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellSave"></a>xmlShellSave ()</h3><pre class="programlisting">int xmlShellSave (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *filename,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "save"
Write the current document to the filename, or it's original name</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the file name (optional)
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellValidate"></a>xmlShellValidate ()</h3><pre class="programlisting">int xmlShellValidate (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *dtd,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "validate"
Validate the document, if a DTD path is provided, then the validation
is done against the given DTD.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> the DTD URI (optional)
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellDu"></a>xmlShellDu ()</h3><pre class="programlisting">int xmlShellDu (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *arg,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> tree,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "du"
show the structure of the subtree under node <i><tt>tree</tt></i>
If <i><tt>tree</tt></i> is null, the command works on the current node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>arg</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><i><tt>tree</tt></i>:</span></td><td> a node defining a subtree
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShellPwd"></a>xmlShellPwd ()</h3><pre class="programlisting">int xmlShellPwd (<a href="libxml-debugXML.html#xmlShellCtxtPtr">xmlShellCtxtPtr</a> ctxt,
char *buffer,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Implements the XML shell function "pwd"
Show the full path from the root to the node, if needed building
thumblers when similar elements exists at a given ancestor level.
The output is compatible with XPath commands.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the shell context
</td></tr><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> the output buffer
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a node
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> unused
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlShell"></a>xmlShell ()</h3><pre class="programlisting">void xmlShell (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
char *filename,
<a href="libxml-debugXML.html#xmlShellReadlineFunc">xmlShellReadlineFunc</a> input,
<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output);</pre><p>
Implements the XML shell
This allow to load, validate, view, modify and save a document
using a environment similar to a UNIX commandline.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the initial document
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the output buffer
</td></tr><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> the line reading function
</td></tr><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the output FILE*, defaults to stdout if NULL
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlreader.html"><b>&lt;&lt; xmlreader</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlwriter.html"><b>xmlwriter &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,12 +28,24 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-DOCBparser.html" title="DOCBparser"><link rel="next" href="libxml-xmlautomata.html" title="xmlautomata"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-DOCBparser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlautomata.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-dict"></a><div class="titlepage"></div><div class="refnamediv"><h2>dict</h2><p>dict &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2682251"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-DOCBparser.html" title="DOCBparser"><link rel="next" href="libxml-xmlautomata.html" title="xmlautomata"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-DOCBparser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlautomata.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-dict"></a><div class="titlepage"></div><div class="refnamediv"><h2>dict</h2><p>dict &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2644652"></a>Synopsis</h1></h2><pre class="synopsis">
struct <a href="libxml-dict.html#xmlDict">xmlDict</a>;
typedef <a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a>;
<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> <a href="libxml-dict.html#xmlDictCreate">xmlDictCreate</a> (void);
int <a href="libxml-dict.html#xmlDictReference">xmlDictReference</a> (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict);
void <a href="libxml-dict.html#xmlDictFree">xmlDictFree</a> (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-dict.html#xmlDictLookup">xmlDictLookup</a> (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int len);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-dict.html#xmlDictQLookup">xmlDictQLookup</a> (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
int <a href="libxml-dict.html#xmlDictOwns">xmlDictOwns</a> (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);
int <a href="libxml-dict.html#xmlDictSize">xmlDictSize</a> (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlDict"></a>struct xmlDict</h3><pre class="programlisting">struct xmlDict;</pre><p>
@ -41,4 +53,50 @@ typedef <a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a>;
</p></div><hr><div class="refsect2"><h3><a name="xmlDictPtr"></a>xmlDictPtr</h3><pre class="programlisting">typedef xmlDict *xmlDictPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-DOCBparser.html"><b>&lt;&lt; DOCBparser</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlautomata.html"><b>xmlautomata &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlDictCreate"></a>xmlDictCreate ()</h3><pre class="programlisting"><a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> xmlDictCreate (void);</pre><p>
Create a new dictionary</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object, or NULL if an error occured.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDictReference"></a>xmlDictReference ()</h3><pre class="programlisting">int xmlDictReference (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict);</pre><p>
Increment the reference counter of a dictionary</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dict</tt></i>:</span></td><td> the dictionnary
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDictFree"></a>xmlDictFree ()</h3><pre class="programlisting">void xmlDictFree (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict);</pre><p>
Free the hash <i><tt>dict</tt></i> and its contents. The userdata is
deallocated with <i><tt>f</tt></i> if provided.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dict</tt></i>:</span></td><td> the dictionnary
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDictLookup"></a>xmlDictLookup ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlDictLookup (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int len);</pre><p>
Add the <i><tt>name</tt></i> to the hash <i><tt>dict</tt></i> if not present.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dict</tt></i>:</span></td><td> the dictionnary
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the length of the name, if -1 it is recomputed
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the internal copy of the name or NULL in case of internal error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDictQLookup"></a>xmlDictQLookup ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlDictQLookup (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Add the QName <i><tt>prefix</tt></i>:<i><tt>name</tt></i> to the hash <i><tt>dict</tt></i> if not present.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dict</tt></i>:</span></td><td> the dictionnary
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the prefix
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the internal copy of the QName or NULL in case of internal error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDictOwns"></a>xmlDictOwns ()</h3><pre class="programlisting">int xmlDictOwns (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);</pre><p>
check if a string is owned by the disctionary</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dict</tt></i>:</span></td><td> the dictionnary
</td></tr><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true, 0 if false and -1 in case of error
-1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDictSize"></a>xmlDictSize ()</h3><pre class="programlisting">int xmlDictSize (<a href="libxml-dict.html#xmlDictPtr">xmlDictPtr</a> dict);</pre><p>
Query the number of elements installed in the hash <i><tt>dict</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dict</tt></i>:</span></td><td> the dictionnary
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of elements in the dictionnary or
-1 in case of error
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-DOCBparser.html"><b>&lt;&lt; DOCBparser</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlautomata.html"><b>xmlautomata &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-wsockcompat.html" title="wsockcompat"><link rel="next" href="libxml-xmlregexp.html" title="xmlregexp"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-wsockcompat.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlregexp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-encoding"></a><div class="titlepage"></div><div class="refnamediv"><h2>encoding</h2><p>encoding &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2614988"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-wsockcompat.html" title="wsockcompat"><link rel="next" href="libxml-xmlregexp.html" title="xmlregexp"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-wsockcompat.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlregexp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-encoding"></a><div class="titlepage"></div><div class="refnamediv"><h2>encoding</h2><p>encoding &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2586513"></a>Synopsis</h1></h2><pre class="synopsis">
@ -43,6 +43,62 @@ int (<a href="libxml-encoding.html#xmlCharEncodingOutputFunc">*xmlCharEn
int *inlen);
struct <a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a>;
typedef <a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a>;
void <a href="libxml-encoding.html#xmlInitCharEncodingHandlers">xmlInitCharEncodingHandlers</a> (void);
void <a href="libxml-encoding.html#xmlCleanupCharEncodingHandlers">xmlCleanupCharEncodingHandlers</a> (void);
void <a href="libxml-encoding.html#xmlRegisterCharEncodingHandler">xmlRegisterCharEncodingHandler</a> (<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> handler);
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> <a href="libxml-encoding.html#xmlGetCharEncodingHandler">xmlGetCharEncodingHandler</a>
(<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> <a href="libxml-encoding.html#xmlFindCharEncodingHandler">xmlFindCharEncodingHandler</a>
(const char *name);
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> <a href="libxml-encoding.html#xmlNewCharEncodingHandler">xmlNewCharEncodingHandler</a>
(const char *name,
<a href="libxml-encoding.html#xmlCharEncodingInputFunc">xmlCharEncodingInputFunc</a> input,
<a href="libxml-encoding.html#xmlCharEncodingOutputFunc">xmlCharEncodingOutputFunc</a> output);
int <a href="libxml-encoding.html#xmlAddEncodingAlias">xmlAddEncodingAlias</a> (const char *name,
const char *alias);
int <a href="libxml-encoding.html#xmlDelEncodingAlias">xmlDelEncodingAlias</a> (const char *alias);
const char* <a href="libxml-encoding.html#xmlGetEncodingAlias">xmlGetEncodingAlias</a> (const char *alias);
void <a href="libxml-encoding.html#xmlCleanupEncodingAliases">xmlCleanupEncodingAliases</a> (void);
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> <a href="libxml-encoding.html#xmlParseCharEncoding">xmlParseCharEncoding</a> (const char *name);
const char* <a href="libxml-encoding.html#xmlGetCharEncodingName">xmlGetCharEncodingName</a> (<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> <a href="libxml-encoding.html#xmlDetectCharEncoding">xmlDetectCharEncoding</a> (unsigned char *in,
int len);
int <a href="libxml-encoding.html#xmlCharEncOutFunc">xmlCharEncOutFunc</a> (<a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a> *handler,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> out,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> in);
int <a href="libxml-encoding.html#xmlCharEncInFunc">xmlCharEncInFunc</a> (<a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a> *handler,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> out,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> in);
int <a href="libxml-encoding.html#xmlCharEncFirstLine">xmlCharEncFirstLine</a> (<a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a> *handler,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> out,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> in);
int <a href="libxml-encoding.html#xmlCharEncCloseFunc">xmlCharEncCloseFunc</a> (<a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a> *handler);
int <a href="libxml-encoding.html#UTF8Toisolat1">UTF8Toisolat1</a> (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen);
int <a href="libxml-encoding.html#isolat1ToUTF8">isolat1ToUTF8</a> (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen);
int <a href="libxml-encoding.html#xmlGetUTF8Char">xmlGetUTF8Char</a> (unsigned char *utf,
int *len);
int <a href="libxml-encoding.html#xmlCheckUTF8">xmlCheckUTF8</a> (unsigned char *utf);
int <a href="libxml-encoding.html#xmlUTF8Strsize">xmlUTF8Strsize</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
int len);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-encoding.html#xmlUTF8Strndup">xmlUTF8Strndup</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
int len);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-encoding.html#xmlUTF8Strpos">xmlUTF8Strpos</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
int pos);
int <a href="libxml-encoding.html#xmlUTF8Strloc">xmlUTF8Strloc</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utfchar);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-encoding.html#xmlUTF8Strsub">xmlUTF8Strsub</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
int start,
int len);
int <a href="libxml-encoding.html#xmlUTF8Strlen">xmlUTF8Strlen</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf);
int <a href="libxml-encoding.html#xmlUTF8Size">xmlUTF8Size</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf);
int <a href="libxml-encoding.html#xmlUTF8Charcmp">xmlUTF8Charcmp</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf1,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf2);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlCharEncoding"></a>enum xmlCharEncoding</h3><pre class="programlisting">typedef enum {
@ -72,20 +128,6 @@ typedef <a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEnco
XML_CHAR_ENCODING_ASCII= 22 /* pure ASCII */
} xmlCharEncoding;
</pre><p>
Predefined values for some standard encodings.
Libxml don't do beforehand translation on UTF8, ISOLatinX.
It also support UTF16 (LE and BE) by default.
</p><p>
Anything else would have to be translated to UTF8 before being
given to the parser itself. The BOM for UTF16 and the encoding
declaration are looked at and a converter is looked for at that
point. If not found the parser stops here as asked by the XML REC
Converter can be registered by the user using xmlRegisterCharEncodingHandler
but the current form doesn't allow stateful transcoding (a serious
problem agreed !). If iconv has been found it will be used
automatically and allow stateful transcoding, the simplest is then
to be sure to enable icon and to provide iconv libs for the encoding
support needed.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlCharEncodingInputFunc"></a>xmlCharEncodingInputFunc ()</h3><pre class="programlisting">int (*xmlCharEncodingInputFunc) (unsigned char *out,
int *outlen,
@ -136,4 +178,240 @@ The value of <i><tt>outlen</tt></i> after return is the number of ocetes consume
</p></div><hr><div class="refsect2"><h3><a name="xmlCharEncodingHandlerPtr"></a>xmlCharEncodingHandlerPtr</h3><pre class="programlisting">typedef xmlCharEncodingHandler *xmlCharEncodingHandlerPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-wsockcompat.html"><b>&lt;&lt; wsockcompat</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlregexp.html"><b>xmlregexp &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlInitCharEncodingHandlers"></a>xmlInitCharEncodingHandlers ()</h3><pre class="programlisting">void xmlInitCharEncodingHandlers (void);</pre><p>
Initialize the char encoding support, it registers the default
encoding supported.
NOTE: while public, this function usually doesn't need to be called
in normal processing.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlCleanupCharEncodingHandlers"></a>xmlCleanupCharEncodingHandlers ()</h3><pre class="programlisting">void xmlCleanupCharEncodingHandlers (void);</pre><p>
Cleanup the memory allocated for the char encoding support, it
unregisters all the encoding handlers and the aliases.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlRegisterCharEncodingHandler"></a>xmlRegisterCharEncodingHandler ()</h3><pre class="programlisting">void xmlRegisterCharEncodingHandler (<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> handler);</pre><p>
Register the char encoding handler, surprising, isn't it ?</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td> the xmlCharEncodingHandlerPtr handler block
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetCharEncodingHandler"></a>xmlGetCharEncodingHandler ()</h3><pre class="programlisting"><a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> xmlGetCharEncodingHandler
(<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Search in the registered set the handler able to read/write that encoding.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> an xmlCharEncoding value.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the handler or NULL if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFindCharEncodingHandler"></a>xmlFindCharEncodingHandler ()</h3><pre class="programlisting"><a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> xmlFindCharEncodingHandler
(const char *name);</pre><p>
Search in the registered set the handler able to read/write that encoding.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> a string describing the char encoding.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the handler or NULL if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNewCharEncodingHandler"></a>xmlNewCharEncodingHandler ()</h3><pre class="programlisting"><a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> xmlNewCharEncodingHandler
(const char *name,
<a href="libxml-encoding.html#xmlCharEncodingInputFunc">xmlCharEncodingInputFunc</a> input,
<a href="libxml-encoding.html#xmlCharEncodingOutputFunc">xmlCharEncodingOutputFunc</a> output);</pre><p>
Create and registers an xmlCharEncodingHandler.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the encoding name, in UTF-8 format (ASCII actually)
</td></tr><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> the xmlCharEncodingInputFunc to read that encoding
</td></tr><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the xmlCharEncodingOutputFunc to write that encoding
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlCharEncodingHandlerPtr created (or NULL in case of error).
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAddEncodingAlias"></a>xmlAddEncodingAlias ()</h3><pre class="programlisting">int xmlAddEncodingAlias (const char *name,
const char *alias);</pre><p>
Registers and alias <i><tt>alias</tt></i> for an encoding named <i><tt>name</tt></i>. Existing alias
will be overwritten.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the encoding name as parsed, in UTF-8 format (ASCII actually)
</td></tr><tr><td><span class="term"><i><tt>alias</tt></i>:</span></td><td> the alias name as parsed, in UTF-8 format (ASCII actually)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success, -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDelEncodingAlias"></a>xmlDelEncodingAlias ()</h3><pre class="programlisting">int xmlDelEncodingAlias (const char *alias);</pre><p>
Unregisters an encoding alias <i><tt>alias</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>alias</tt></i>:</span></td><td> the alias name as parsed, in UTF-8 format (ASCII actually)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success, -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetEncodingAlias"></a>xmlGetEncodingAlias ()</h3><pre class="programlisting">const char* xmlGetEncodingAlias (const char *alias);</pre><p>
Lookup an encoding name for the given alias.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>alias</tt></i>:</span></td><td> the alias name as parsed, in UTF-8 format (ASCII actually)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not found the original name otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCleanupEncodingAliases"></a>xmlCleanupEncodingAliases ()</h3><pre class="programlisting">void xmlCleanupEncodingAliases (void);</pre><p>
Unregisters all aliases</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlParseCharEncoding"></a>xmlParseCharEncoding ()</h3><pre class="programlisting"><a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> xmlParseCharEncoding (const char *name);</pre><p>
Compare the string to the known encoding schemes already known. Note
that the comparison is case insensitive accordingly to the section
[XML] 4.3.3 Character Encoding in Entities.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the encoding name as parsed, in UTF-8 format (ASCII actually)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>one of the XML_CHAR_ENCODING_... values or XML_CHAR_ENCODING_NONE
if not recognized.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetCharEncodingName"></a>xmlGetCharEncodingName ()</h3><pre class="programlisting">const char* xmlGetCharEncodingName (<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
The "canonical" name for XML encoding.
C.f. http://www.w3.org/TR/REC-xml<GTKDOCLINK HREF="charencoding">charencoding</GTKDOCLINK>
Section 4.3.3 Character Encoding in Entities</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> the encoding
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the canonical name for the given encoding
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDetectCharEncoding"></a>xmlDetectCharEncoding ()</h3><pre class="programlisting"><a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> xmlDetectCharEncoding (unsigned char *in,
int len);</pre><p>
Guess the encoding of the entity using the first bytes of the entity content
accordingly of the non-normative appendix F of the XML-1.0 recommendation.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to the first bytes of the XML entity, must be at least
4 bytes long.
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> pointer to the length of the buffer
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>one of the XML_CHAR_ENCODING_... values.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCharEncOutFunc"></a>xmlCharEncOutFunc ()</h3><pre class="programlisting">int xmlCharEncOutFunc (<a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a> *handler,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> out,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> in);</pre><p>
Generic front-end for the encoding handler output function
a first call with <i><tt>in</tt></i> == NULL has to be made firs to initiate the
output in case of non-stateless encoding needing to initiate their
state or the output (like the BOM in UTF16).
In case of UTF8 sequence conversion errors for the given encoder,
the content will be automatically remapped to a CharRef sequence.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td> char enconding transformation data structure
</td></tr><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> an xmlBuffer for the output.
</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> an xmlBuffer for the input
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte written if success, or
-1 general error
-2 if the transcoding fails (for *in is not valid utf8 string or
the result of transformation can't fit into the encoding we want), or
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCharEncInFunc"></a>xmlCharEncInFunc ()</h3><pre class="programlisting">int xmlCharEncInFunc (<a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a> *handler,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> out,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> in);</pre><p>
Generic front-end for the encoding handler input function</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td> char encoding transformation data structure
</td></tr><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> an xmlBuffer for the output.
</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> an xmlBuffer for the input
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte written if success, or
-1 general error
-2 if the transcoding fails (for *in is not valid utf8 string or
the result of transformation can't fit into the encoding we want), or
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCharEncFirstLine"></a>xmlCharEncFirstLine ()</h3><pre class="programlisting">int xmlCharEncFirstLine (<a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a> *handler,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> out,
<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> in);</pre><p>
Front-end for the encoding handler input function, but handle only
the very first line, i.e. limit itself to 45 chars.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td> char enconding transformation data structure
</td></tr><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> an xmlBuffer for the output.
</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> an xmlBuffer for the input
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte written if success, or
-1 general error
-2 if the transcoding fails (for *in is not valid utf8 string or
the result of transformation can't fit into the encoding we want), or
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCharEncCloseFunc"></a>xmlCharEncCloseFunc ()</h3><pre class="programlisting">int xmlCharEncCloseFunc (<a href="libxml-encoding.html#xmlCharEncodingHandler">xmlCharEncodingHandler</a> *handler);</pre><p>
Generic front-end for encoding handler close function</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td> char enconding transformation data structure
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="UTF8Toisolat1"></a>UTF8Toisolat1 ()</h3><pre class="programlisting">int UTF8Toisolat1 (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen);</pre><p>
Take a block of UTF-8 chars in and try to convert it to an ISO Latin 1
block of chars out.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a pointer to an array of bytes to store the result
</td></tr><tr><td><span class="term"><i><tt>outlen</tt></i>:</span></td><td> the length of <i><tt>out</tt></i>
</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to an array of UTF-8 chars
</td></tr><tr><td><span class="term"><i><tt>inlen</tt></i>:</span></td><td> the length of <i><tt>in</tt></i>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, -2 if the transcoding fails, or -1 otherwise
The value of <i><tt>inlen</tt></i> after return is the number of octets consumed
as the return value is positive, else unpredictable.
The value of <i><tt>outlen</tt></i> after return is the number of ocetes consumed.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="isolat1ToUTF8"></a>isolat1ToUTF8 ()</h3><pre class="programlisting">int isolat1ToUTF8 (unsigned char *out,
int *outlen,
unsigned char *in,
int *inlen);</pre><p>
Take a block of ISO Latin 1 chars in and try to convert it to an UTF-8
block of chars out.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a pointer to an array of bytes to store the result
</td></tr><tr><td><span class="term"><i><tt>outlen</tt></i>:</span></td><td> the length of <i><tt>out</tt></i>
</td></tr><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a pointer to an array of ISO Latin 1 chars
</td></tr><tr><td><span class="term"><i><tt>inlen</tt></i>:</span></td><td> the length of <i><tt>in</tt></i>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if success, or -1 otherwise
The value of <i><tt>inlen</tt></i> after return is the number of octets consumed
as the return value is positive, else unpredictable.
The value of <i><tt>outlen</tt></i> after return is the number of ocetes consumed.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetUTF8Char"></a>xmlGetUTF8Char ()</h3><pre class="programlisting">int xmlGetUTF8Char (unsigned char *utf,
int *len);</pre><p>
Read one UTF8 Char from <i><tt>utf</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> a sequence of UTF-8 encoded bytes
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> a pointer to <i><tt>bytes</tt></i> len
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the char value or -1 in case of error and update <i><tt>len</tt></i> with the
number of bytes used
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCheckUTF8"></a>xmlCheckUTF8 ()</h3><pre class="programlisting">int xmlCheckUTF8 (unsigned char *utf);</pre><p>
Checks <i><tt>utf</tt></i> for being valid utf-8. <i><tt>utf</tt></i> is assumed to be
null-terminated. This function is not super-strict, as it will
allow longer utf-8 sequences than necessary. Note that Java is
capable of producing these sequences if provoked. Also note, this
routine checks for the 4-byte maximum size, but does not check for
0x10ffff maximum value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> Pointer to putative utf-8 encoded string.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> true if <i><tt>utf</tt></i> is valid.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlUTF8Strsize"></a>xmlUTF8Strsize ()</h3><pre class="programlisting">int xmlUTF8Strsize (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
int len);</pre><p>
storage size of an UTF8 string</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> a sequence of UTF-8 encoded bytes
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the number of characters in the array
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the storage size of
the first 'len' characters of ARRAY
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlUTF8Strndup"></a>xmlUTF8Strndup ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlUTF8Strndup (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
int len);</pre><p>
a strndup for array of UTF8's</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> the input UTF8 *
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the len of <i><tt>utf</tt></i> (in chars)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new UTF8 * or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlUTF8Strpos"></a>xmlUTF8Strpos ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlUTF8Strpos (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
int pos);</pre><p>
a function to provide the equivalent of fetching a
character from a string array</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> the input UTF8 *
</td></tr><tr><td><span class="term"><i><tt>pos</tt></i>:</span></td><td> the position of the desired UTF8 char (in chars)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a pointer to the UTF8 character or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlUTF8Strloc"></a>xmlUTF8Strloc ()</h3><pre class="programlisting">int xmlUTF8Strloc (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utfchar);</pre><p>
a function to provide relative location of a UTF8 char</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> the input UTF8 *
</td></tr><tr><td><span class="term"><i><tt>utfchar</tt></i>:</span></td><td> the UTF8 character to be found
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the relative character position of the desired char
or -1 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlUTF8Strsub"></a>xmlUTF8Strsub ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlUTF8Strsub (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf,
int start,
int len);</pre><p>
Note: positions are given in units of UTF-8 chars</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> a sequence of UTF-8 encoded bytes
</td></tr><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> relative pos of first char
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> total number to copy
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a pointer to a newly created string
or NULL if any problem
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlUTF8Strlen"></a>xmlUTF8Strlen ()</h3><pre class="programlisting">int xmlUTF8Strlen (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf);</pre><p>
compute the length of an UTF8 string, it doesn't do a full UTF8
checking of the content of the string.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> a sequence of UTF-8 encoded bytes
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of characters in the string or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlUTF8Size"></a>xmlUTF8Size ()</h3><pre class="programlisting">int xmlUTF8Size (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf);</pre><p>
calulates the internal size of a UTF8 character</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf</tt></i>:</span></td><td> pointer to the UTF8 character
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the numbers of bytes in the character, -1 on format error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlUTF8Charcmp"></a>xmlUTF8Charcmp ()</h3><pre class="programlisting">int xmlUTF8Charcmp (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf1,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *utf2);</pre><p>
compares the two UCS4 values</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>utf1</tt></i>:</span></td><td> pointer to first UTF8 char
</td></tr><tr><td><span class="term"><i><tt>utf2</tt></i>:</span></td><td> pointer to second UTF8 char
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>result of the compare as with xmlStrncmp
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-wsockcompat.html"><b>&lt;&lt; wsockcompat</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlregexp.html"><b>xmlregexp &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,13 +28,47 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-parserInternals.html" title="parserInternals"><link rel="next" href="libxml-HTMLparser.html" title="HTMLparser"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-parserInternals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-HTMLparser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-entities"></a><div class="titlepage"></div><div class="refnamediv"><h2>entities</h2><p>entities &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2684512"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-parserInternals.html" title="parserInternals"><link rel="next" href="libxml-HTMLparser.html" title="HTMLparser"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-parserInternals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-HTMLparser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-entities"></a><div class="titlepage"></div><div class="refnamediv"><h2>entities</h2><p>entities &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2675364"></a>Synopsis</h1></h2><pre class="synopsis">
enum <a href="libxml-entities.html#xmlEntityType">xmlEntityType</a>;
struct <a href="libxml-entities.html#xmlEntity">xmlEntity</a>;
typedef <a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a>;
void <a href="libxml-entities.html#xmlInitializePredefinedEntities">xmlInitializePredefinedEntities</a> (void);
<a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlAddDocEntity">xmlAddDocEntity</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
<a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlAddDtdEntity">xmlAddDtdEntity</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
<a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlGetPredefinedEntity">xmlGetPredefinedEntity</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
<a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlGetDocEntity">xmlGetDocEntity</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
<a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlGetDtdEntity">xmlGetDtdEntity</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
<a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlGetParameterEntity">xmlGetParameterEntity</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-entities.html#xmlEncodeEntities">xmlEncodeEntities</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-entities.html#xmlEncodeEntitiesReentrant">xmlEncodeEntitiesReentrant</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-entities.html#xmlEncodeSpecialChars">xmlEncodeSpecialChars</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);
<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> <a href="libxml-entities.html#xmlCreateEntitiesTable">xmlCreateEntitiesTable</a> (void);
<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> <a href="libxml-entities.html#xmlCopyEntitiesTable">xmlCopyEntitiesTable</a> (<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);
void <a href="libxml-entities.html#xmlFreeEntitiesTable">xmlFreeEntitiesTable</a> (<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);
void <a href="libxml-entities.html#xmlDumpEntitiesTable">xmlDumpEntitiesTable</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);
void <a href="libxml-entities.html#xmlDumpEntityDecl">xmlDumpEntityDecl</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> ent);
void <a href="libxml-entities.html#xmlCleanupPredefinedEntities">xmlCleanupPredefinedEntities</a> (void);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlEntityType"></a>enum xmlEntityType</h3><pre class="programlisting">typedef enum {
@ -75,4 +109,127 @@ typedef <a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTableP
</p></div><hr><div class="refsect2"><h3><a name="xmlEntitiesTablePtr"></a>xmlEntitiesTablePtr</h3><pre class="programlisting">typedef xmlEntitiesTable *xmlEntitiesTablePtr;
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlInitializePredefinedEntities"></a>xmlInitializePredefinedEntities ()</h3><pre class="programlisting">void xmlInitializePredefinedEntities (void);</pre><p>
Set up the predefined entities.
Deprecated call</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlAddDocEntity"></a>xmlAddDocEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlAddDocEntity (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Register a new entity for this document.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the entity type XML_xxx_yyy_ENTITY
</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the entity external ID if available
</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i>:</span></td><td> the entity system ID if available
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> the entity content
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a pointer to the entity or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAddDtdEntity"></a>xmlAddDtdEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlAddDtdEntity (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
int type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Register a new entity for this document DTD external subset.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the entity type XML_xxx_yyy_ENTITY
</td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i>:</span></td><td> the entity external ID if available
</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i>:</span></td><td> the entity system ID if available
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> the entity content
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a pointer to the entity or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetPredefinedEntity"></a>xmlGetPredefinedEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlGetPredefinedEntity (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Check whether this name is an predefined entity.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not, otherwise the entity
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetDocEntity"></a>xmlGetDocEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlGetDocEntity (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Do an entity lookup in the document entity hash table and
returns the corresponding entity, otherwise a lookup is done
in the predefined entities too.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document referencing the entity
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>A pointer to the entity structure or NULL if not found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetDtdEntity"></a>xmlGetDtdEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlGetDtdEntity (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Do an entity lookup in the DTD entity hash table and
returns the corresponding entity, if found.
Note: the first argument is the document node, not the DTD node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document referencing the entity
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>A pointer to the entity structure or NULL if not found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetParameterEntity"></a>xmlGetParameterEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlGetParameterEntity (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Do an entity lookup in the internal and external subsets and
returns the corresponding parameter entity, if found.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document referencing the entity
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>A pointer to the entity structure or NULL if not found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlEncodeEntities"></a>xmlEncodeEntities ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlEncodeEntities (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);</pre><p>
TODO: remove xmlEncodeEntities, once we are not afraid of breaking binary
compatibility
</p><p>
People must migrate their code to xmlEncodeEntitiesReentrant !
This routine will issue a warning when encountered.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document containing the string
</td></tr><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> A string to convert to XML.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlEncodeEntitiesReentrant"></a>xmlEncodeEntitiesReentrant ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlEncodeEntitiesReentrant (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);</pre><p>
Do a global encoding of a string, replacing the predefined entities
and non ASCII values with their entities and CharRef counterparts.
Contrary to xmlEncodeEntities, this routine is reentrant, and result
must be deallocated.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document containing the string
</td></tr><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> A string to convert to XML.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>A newly allocated string with the substitution done.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlEncodeSpecialChars"></a>xmlEncodeSpecialChars ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlEncodeSpecialChars (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);</pre><p>
Do a global encoding of a string, replacing the predefined entities
this routine is reentrant, and result must be deallocated.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document containing the string
</td></tr><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> A string to convert to XML.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>A newly allocated string with the substitution done.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCreateEntitiesTable"></a>xmlCreateEntitiesTable ()</h3><pre class="programlisting"><a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> xmlCreateEntitiesTable (void);</pre><p>
create and initialize an empty entities hash table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlEntitiesTablePtr just created or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCopyEntitiesTable"></a>xmlCopyEntitiesTable ()</h3><pre class="programlisting"><a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> xmlCopyEntitiesTable (<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);</pre><p>
Build a copy of an entity table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An entity table
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlEntitiesTablePtr or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeEntitiesTable"></a>xmlFreeEntitiesTable ()</h3><pre class="programlisting">void xmlFreeEntitiesTable (<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);</pre><p>
Deallocate the memory used by an entities hash table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An entity table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDumpEntitiesTable"></a>xmlDumpEntitiesTable ()</h3><pre class="programlisting">void xmlDumpEntitiesTable (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);</pre><p>
This will dump the content of the entity table as an XML DTD definition</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> An XML buffer.
</td></tr><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An entity table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDumpEntityDecl"></a>xmlDumpEntityDecl ()</h3><pre class="programlisting">void xmlDumpEntityDecl (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> ent);</pre><p>
This will dump the content of the entity table as an XML DTD definition</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> An XML buffer.
</td></tr><tr><td><span class="term"><i><tt>ent</tt></i>:</span></td><td> An entity table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCleanupPredefinedEntities"></a>xmlCleanupPredefinedEntities ()</h3><pre class="programlisting">void xmlCleanupPredefinedEntities (void);</pre><p>
Cleanup up the predefined entities table.
Deprecated call</p><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-parserInternals.html"><b>&lt;&lt; parserInternals</b></a></td><td align="right"><a accesskey="n" href="libxml-HTMLparser.html"><b>HTMLparser &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,14 +28,28 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-tree.html" title="tree"><link rel="next" href="libxml-xmlexports.html" title="xmlexports"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-tree.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlexports.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-globals"></a><div class="titlepage"></div><div class="refnamediv"><h2>globals</h2><p>globals &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2594532"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-tree.html" title="tree"><link rel="next" href="libxml-xmlunicode.html" title="xmlunicode"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-tree.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlunicode.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-globals"></a><div class="titlepage"></div><div class="refnamediv"><h2>globals</h2><p>globals &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2839615"></a>Synopsis</h1></h2><pre class="synopsis">
void <a href="libxml-globals.html#xmlInitGlobals">xmlInitGlobals</a> (void);
void <a href="libxml-globals.html#xmlCleanupGlobals">xmlCleanupGlobals</a> (void);
void (<a href="libxml-globals.html#xmlRegisterNodeFunc">*xmlRegisterNodeFunc</a>) (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);
void (<a href="libxml-globals.html#xmlDeregisterNodeFunc">*xmlDeregisterNodeFunc</a>) (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);
struct <a href="libxml-globals.html#xmlGlobalState">xmlGlobalState</a>;
typedef <a href="libxml-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a>;
void <a href="libxml-globals.html#xmlInitializeGlobalState">xmlInitializeGlobalState</a> (<a href="libxml-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a> gs);
void <a href="libxml-globals.html#xmlThrDefSetGenericErrorFunc">xmlThrDefSetGenericErrorFunc</a> (void *ctx,
<a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> handler);
void <a href="libxml-globals.html#xmlThrDefSetStructuredErrorFunc">xmlThrDefSetStructuredErrorFunc</a> (void *ctx,
<a href="libxml-xmlerror.html#xmlStructuredErrorFunc">xmlStructuredErrorFunc</a> handler);
<a href="libxml-globals.html#xmlRegisterNodeFunc">xmlRegisterNodeFunc</a> <a href="libxml-globals.html#xmlRegisterNodeDefault">xmlRegisterNodeDefault</a> (<a href="libxml-globals.html#xmlRegisterNodeFunc">xmlRegisterNodeFunc</a> func);
<a href="libxml-globals.html#xmlRegisterNodeFunc">xmlRegisterNodeFunc</a> <a href="libxml-globals.html#xmlThrDefRegisterNodeDefault">xmlThrDefRegisterNodeDefault</a>
(<a href="libxml-globals.html#xmlRegisterNodeFunc">xmlRegisterNodeFunc</a> func);
<a href="libxml-globals.html#xmlDeregisterNodeFunc">xmlDeregisterNodeFunc</a> <a href="libxml-globals.html#xmlDeregisterNodeDefault">xmlDeregisterNodeDefault</a>
(<a href="libxml-globals.html#xmlDeregisterNodeFunc">xmlDeregisterNodeFunc</a> func);
<a href="libxml-globals.html#xmlDeregisterNodeFunc">xmlDeregisterNodeFunc</a> <a href="libxml-globals.html#xmlThrDefDeregisterNodeDefault">xmlThrDefDeregisterNodeDefault</a>
(<a href="libxml-globals.html#xmlDeregisterNodeFunc">xmlDeregisterNodeFunc</a> func);
#define <a href="libxml-xmlmemory.html#xmlMalloc">xmlMalloc</a> (size)
#define <a href="libxml-xmlmemory.html#xmlMallocAtomic">xmlMallocAtomic</a> (size)
#define <a href="libxml-xmlmemory.html#xmlRealloc">xmlRealloc</a> (ptr, size)
@ -46,29 +60,52 @@ typedef <a href="libxml-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a
#define <a href="libxml-globals.html#xmlLastError">xmlLastError</a>
#define <a href="libxml-globals.html#oldXMLWDcompatibility">oldXMLWDcompatibility</a>
#define <a href="libxml-globals.html#xmlBufferAllocScheme">xmlBufferAllocScheme</a>
<a href="libxml-tree.html#xmlBufferAllocationScheme">xmlBufferAllocationScheme</a> <a href="libxml-globals.html#xmlThrDefBufferAllocScheme">xmlThrDefBufferAllocScheme</a>
(<a href="libxml-tree.html#xmlBufferAllocationScheme">xmlBufferAllocationScheme</a> v);
#define <a href="libxml-globals.html#xmlDefaultBufferSize">xmlDefaultBufferSize</a>
int <a href="libxml-globals.html#xmlThrDefDefaultBufferSize">xmlThrDefDefaultBufferSize</a> (int v);
#define <a href="libxml-globals.html#xmlDefaultSAXHandler">xmlDefaultSAXHandler</a>
#define <a href="libxml-globals.html#xmlDefaultSAXLocator">xmlDefaultSAXLocator</a>
#define <a href="libxml-globals.html#xmlDoValidityCheckingDefaultValue">xmlDoValidityCheckingDefaultValue</a>
int <a href="libxml-globals.html#xmlThrDefDoValidityCheckingDefaultValue">xmlThrDefDoValidityCheckingDefaultValue</a>
(int v);
#define <a href="libxml-globals.html#xmlGenericError">xmlGenericError</a>
#define <a href="libxml-globals.html#xmlStructuredError">xmlStructuredError</a>
#define <a href="libxml-globals.html#xmlGenericErrorContext">xmlGenericErrorContext</a>
#define <a href="libxml-globals.html#xmlGetWarningsDefaultValue">xmlGetWarningsDefaultValue</a>
int <a href="libxml-globals.html#xmlThrDefGetWarningsDefaultValue">xmlThrDefGetWarningsDefaultValue</a>
(int v);
#define <a href="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a>
int <a href="libxml-globals.html#xmlThrDefIndentTreeOutput">xmlThrDefIndentTreeOutput</a> (int v);
#define <a href="libxml-globals.html#xmlTreeIndentString">xmlTreeIndentString</a>
const char* <a href="libxml-globals.html#xmlThrDefTreeIndentString">xmlThrDefTreeIndentString</a> (const char *v);
#define <a href="libxml-globals.html#xmlKeepBlanksDefaultValue">xmlKeepBlanksDefaultValue</a>
int <a href="libxml-globals.html#xmlThrDefKeepBlanksDefaultValue">xmlThrDefKeepBlanksDefaultValue</a> (int v);
#define <a href="libxml-globals.html#xmlLineNumbersDefaultValue">xmlLineNumbersDefaultValue</a>
int <a href="libxml-globals.html#xmlThrDefLineNumbersDefaultValue">xmlThrDefLineNumbersDefaultValue</a>
(int v);
#define <a href="libxml-globals.html#xmlLoadExtDtdDefaultValue">xmlLoadExtDtdDefaultValue</a>
int <a href="libxml-globals.html#xmlThrDefLoadExtDtdDefaultValue">xmlThrDefLoadExtDtdDefaultValue</a> (int v);
#define <a href="libxml-globals.html#xmlParserDebugEntities">xmlParserDebugEntities</a>
int <a href="libxml-globals.html#xmlThrDefParserDebugEntities">xmlThrDefParserDebugEntities</a> (int v);
#define <a href="libxml-globals.html#xmlParserVersion">xmlParserVersion</a>
#define <a href="libxml-globals.html#xmlPedanticParserDefaultValue">xmlPedanticParserDefaultValue</a>
int <a href="libxml-globals.html#xmlThrDefPedanticParserDefaultValue">xmlThrDefPedanticParserDefaultValue</a>
(int v);
#define <a href="libxml-globals.html#xmlSaveNoEmptyTags">xmlSaveNoEmptyTags</a>
int <a href="libxml-globals.html#xmlThrDefSaveNoEmptyTags">xmlThrDefSaveNoEmptyTags</a> (int v);
#define <a href="libxml-globals.html#xmlSubstituteEntitiesDefaultValue">xmlSubstituteEntitiesDefaultValue</a>
int <a href="libxml-globals.html#xmlThrDefSubstituteEntitiesDefaultValue">xmlThrDefSubstituteEntitiesDefaultValue</a>
(int v);
#define <a href="libxml-globals.html#xmlRegisterNodeDefaultValue">xmlRegisterNodeDefaultValue</a>
#define <a href="libxml-globals.html#xmlDeregisterNodeDefaultValue">xmlDeregisterNodeDefaultValue</a>
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlRegisterNodeFunc"></a>xmlRegisterNodeFunc ()</h3><pre class="programlisting">void (*xmlRegisterNodeFunc) (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);</pre><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlInitGlobals"></a>xmlInitGlobals ()</h3><pre class="programlisting">void xmlInitGlobals (void);</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlCleanupGlobals"></a>xmlCleanupGlobals ()</h3><pre class="programlisting">void xmlCleanupGlobals (void);</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlRegisterNodeFunc"></a>xmlRegisterNodeFunc ()</h3><pre class="programlisting">void (*xmlRegisterNodeFunc) (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td>
@ -125,7 +162,51 @@ typedef <a href="libxml-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a
</p></div><hr><div class="refsect2"><h3><a name="xmlGlobalStatePtr"></a>xmlGlobalStatePtr</h3><pre class="programlisting">typedef xmlGlobalState *xmlGlobalStatePtr;
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlMalloc"></a>xmlMalloc()</h3><pre class="programlisting">#define xmlMalloc(size)</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlInitializeGlobalState"></a>xmlInitializeGlobalState ()</h3><pre class="programlisting">void xmlInitializeGlobalState (<a href="libxml-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a> gs);</pre><p>
<a href="libxml-globals.html#xmlInitializeGlobalState">xmlInitializeGlobalState</a>() initialize a global state with all the
default values of the library.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>gs</tt></i>:</span></td><td> a pointer to a newly allocated global state
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlThrDefSetGenericErrorFunc"></a>xmlThrDefSetGenericErrorFunc ()</h3><pre class="programlisting">void xmlThrDefSetGenericErrorFunc (void *ctx,
<a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> handler);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlThrDefSetStructuredErrorFunc"></a>xmlThrDefSetStructuredErrorFunc ()</h3><pre class="programlisting">void xmlThrDefSetStructuredErrorFunc (void *ctx,
<a href="libxml-xmlerror.html#xmlStructuredErrorFunc">xmlStructuredErrorFunc</a> handler);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegisterNodeDefault"></a>xmlRegisterNodeDefault ()</h3><pre class="programlisting"><a href="libxml-globals.html#xmlRegisterNodeFunc">xmlRegisterNodeFunc</a> xmlRegisterNodeDefault (<a href="libxml-globals.html#xmlRegisterNodeFunc">xmlRegisterNodeFunc</a> func);</pre><p>
Registers a callback for node creation</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>func</tt></i>:</span></td><td> function pointer to the new RegisterNodeFunc
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the old value of the registration function
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlThrDefRegisterNodeDefault"></a>xmlThrDefRegisterNodeDefault ()</h3><pre class="programlisting"><a href="libxml-globals.html#xmlRegisterNodeFunc">xmlRegisterNodeFunc</a> xmlThrDefRegisterNodeDefault
(<a href="libxml-globals.html#xmlRegisterNodeFunc">xmlRegisterNodeFunc</a> func);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>func</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDeregisterNodeDefault"></a>xmlDeregisterNodeDefault ()</h3><pre class="programlisting"><a href="libxml-globals.html#xmlDeregisterNodeFunc">xmlDeregisterNodeFunc</a> xmlDeregisterNodeDefault
(<a href="libxml-globals.html#xmlDeregisterNodeFunc">xmlDeregisterNodeFunc</a> func);</pre><p>
Registers a callback for node destruction</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>func</tt></i>:</span></td><td> function pointer to the new DeregisterNodeFunc
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the previous value of the deregistration function
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlThrDefDeregisterNodeDefault"></a>xmlThrDefDeregisterNodeDefault ()</h3><pre class="programlisting"><a href="libxml-globals.html#xmlDeregisterNodeFunc">xmlDeregisterNodeFunc</a> xmlThrDefDeregisterNodeDefault
(<a href="libxml-globals.html#xmlDeregisterNodeFunc">xmlDeregisterNodeFunc</a> func);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>func</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMalloc"></a>xmlMalloc()</h3><pre class="programlisting">#define xmlMalloc(size)</pre><p>
Wrapper for the <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() function used in the XML library.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td>
@ -149,7 +230,7 @@ Wrapper for the <GTKDOCLINK HREF="realloc">realloc</GTKDOCLINK>() function used
The variable holding the libxml <GTKDOCLINK HREF="free">free</GTKDOCLINK>() implementation</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlMemStrdup"></a>xmlMemStrdup()</h3><pre class="programlisting">#define xmlMemStrdup(str)</pre><p>
Wrapper for the <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() function, <GTKDOCLINK HREF="xmlStrdup">xmlStrdup</GTKDOCLINK>() is usually preferred.</p><p>
Wrapper for the <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() function, <a href="libxml-parser.html#xmlStrdup">xmlStrdup</a>() is usually preferred.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td>
@ -169,10 +250,23 @@ Global setting, DEPRECATED.</p><p>
Global setting, default allocation policy for buffers, default is
XML_BUFFER_ALLOC_EXACT</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlDefaultBufferSize"></a>xmlDefaultBufferSize</h3><pre class="programlisting">#define xmlDefaultBufferSize</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefBufferAllocScheme"></a>xmlThrDefBufferAllocScheme ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlBufferAllocationScheme">xmlBufferAllocationScheme</a> xmlThrDefBufferAllocScheme
(<a href="libxml-tree.html#xmlBufferAllocationScheme">xmlBufferAllocationScheme</a> v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDefaultBufferSize"></a>xmlDefaultBufferSize</h3><pre class="programlisting">#define xmlDefaultBufferSize</pre><p>
Global setting, default buffer size. Default value is BASE_BUFFER_SIZE</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlDefaultSAXHandler"></a>xmlDefaultSAXHandler</h3><pre class="programlisting">#define xmlDefaultSAXHandler</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefDefaultBufferSize"></a>xmlThrDefDefaultBufferSize ()</h3><pre class="programlisting">int xmlThrDefDefaultBufferSize (int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDefaultSAXHandler"></a>xmlDefaultSAXHandler</h3><pre class="programlisting">#define xmlDefaultSAXHandler</pre><p>
Default SAX version1 handler for XML, builds the DOM tree</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlDefaultSAXLocator"></a>xmlDefaultSAXLocator</h3><pre class="programlisting">#define xmlDefaultSAXLocator</pre><p>
@ -183,7 +277,14 @@ The default SAX Locator
Global setting, indicate that the parser should work in validating mode.
Disabled by default.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlGenericError"></a>xmlGenericError</h3><pre class="programlisting">#define xmlGenericError</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefDoValidityCheckingDefaultValue"></a>xmlThrDefDoValidityCheckingDefaultValue ()</h3><pre class="programlisting">int xmlThrDefDoValidityCheckingDefaultValue
(int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGenericError"></a>xmlGenericError</h3><pre class="programlisting">#define xmlGenericError</pre><p>
Global setting: function used for generic error callbacks</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlStructuredError"></a>xmlStructuredError</h3><pre class="programlisting">#define xmlStructuredError</pre><p>
@ -196,58 +297,122 @@ Global setting passed to generic error callbacks</p><p>
Global setting, indicate that the parser should provide warnings.
Activated by default.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlIndentTreeOutput"></a>xmlIndentTreeOutput</h3><pre class="programlisting">#define xmlIndentTreeOutput</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefGetWarningsDefaultValue"></a>xmlThrDefGetWarningsDefaultValue ()</h3><pre class="programlisting">int xmlThrDefGetWarningsDefaultValue
(int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIndentTreeOutput"></a>xmlIndentTreeOutput</h3><pre class="programlisting">#define xmlIndentTreeOutput</pre><p>
Global setting, asking the serializer to indent the output tree by default
Enabled by default</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlTreeIndentString"></a>xmlTreeIndentString</h3><pre class="programlisting">#define xmlTreeIndentString</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefIndentTreeOutput"></a>xmlThrDefIndentTreeOutput ()</h3><pre class="programlisting">int xmlThrDefIndentTreeOutput (int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTreeIndentString"></a>xmlTreeIndentString</h3><pre class="programlisting">#define xmlTreeIndentString</pre><p>
The string used to do one-level indent. By default is equal to " " (two spaces)</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlKeepBlanksDefaultValue"></a>xmlKeepBlanksDefaultValue</h3><pre class="programlisting">#define xmlKeepBlanksDefaultValue</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefTreeIndentString"></a>xmlThrDefTreeIndentString ()</h3><pre class="programlisting">const char* xmlThrDefTreeIndentString (const char *v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlKeepBlanksDefaultValue"></a>xmlKeepBlanksDefaultValue</h3><pre class="programlisting">#define xmlKeepBlanksDefaultValue</pre><p>
Global setting, indicate that the parser should keep all blanks
nodes found in the content
Activated by default, this is actually needed to have the parser
conformant to the XML Recommendation, however the option is kept
for some applications since this was libxml1 default behaviour.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlLineNumbersDefaultValue"></a>xmlLineNumbersDefaultValue</h3><pre class="programlisting">#define xmlLineNumbersDefaultValue</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefKeepBlanksDefaultValue"></a>xmlThrDefKeepBlanksDefaultValue ()</h3><pre class="programlisting">int xmlThrDefKeepBlanksDefaultValue (int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlLineNumbersDefaultValue"></a>xmlLineNumbersDefaultValue</h3><pre class="programlisting">#define xmlLineNumbersDefaultValue</pre><p>
Global setting, indicate that the parser should store the line number
in the content field of elements in the DOM tree.
Disabled by default since this may not be safe for old classes of
applicaton.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlLoadExtDtdDefaultValue"></a>xmlLoadExtDtdDefaultValue</h3><pre class="programlisting">#define xmlLoadExtDtdDefaultValue</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefLineNumbersDefaultValue"></a>xmlThrDefLineNumbersDefaultValue ()</h3><pre class="programlisting">int xmlThrDefLineNumbersDefaultValue
(int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlLoadExtDtdDefaultValue"></a>xmlLoadExtDtdDefaultValue</h3><pre class="programlisting">#define xmlLoadExtDtdDefaultValue</pre><p>
Global setting, indicate that the parser should load DTD while not
validating.
Disabled by default.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlParserDebugEntities"></a>xmlParserDebugEntities</h3><pre class="programlisting">#define xmlParserDebugEntities</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefLoadExtDtdDefaultValue"></a>xmlThrDefLoadExtDtdDefaultValue ()</h3><pre class="programlisting">int xmlThrDefLoadExtDtdDefaultValue (int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserDebugEntities"></a>xmlParserDebugEntities</h3><pre class="programlisting">#define xmlParserDebugEntities</pre><p>
Global setting, asking the parser to print out debugging informations.
while handling entities.
Disabled by default</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlParserVersion"></a>xmlParserVersion</h3><pre class="programlisting">#define xmlParserVersion</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefParserDebugEntities"></a>xmlThrDefParserDebugEntities ()</h3><pre class="programlisting">int xmlThrDefParserDebugEntities (int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserVersion"></a>xmlParserVersion</h3><pre class="programlisting">#define xmlParserVersion</pre><p>
Constant string describing the internal version of the library</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlPedanticParserDefaultValue"></a>xmlPedanticParserDefaultValue</h3><pre class="programlisting">#define xmlPedanticParserDefaultValue</pre><p>
Global setting, indicate that the parser be pedantic
Disabled by default.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlSaveNoEmptyTags"></a>xmlSaveNoEmptyTags</h3><pre class="programlisting">#define xmlSaveNoEmptyTags</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefPedanticParserDefaultValue"></a>xmlThrDefPedanticParserDefaultValue ()</h3><pre class="programlisting">int xmlThrDefPedanticParserDefaultValue
(int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSaveNoEmptyTags"></a>xmlSaveNoEmptyTags</h3><pre class="programlisting">#define xmlSaveNoEmptyTags</pre><p>
Global setting, asking the serializer to not output empty tags
as &lt;empty/&gt; but &lt;empty&gt;&lt;/empty&gt;. those two forms are undistinguishable
once parsed.
Disabled by default</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlSubstituteEntitiesDefaultValue"></a>xmlSubstituteEntitiesDefaultValue</h3><pre class="programlisting">#define xmlSubstituteEntitiesDefaultValue</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefSaveNoEmptyTags"></a>xmlThrDefSaveNoEmptyTags ()</h3><pre class="programlisting">int xmlThrDefSaveNoEmptyTags (int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSubstituteEntitiesDefaultValue"></a>xmlSubstituteEntitiesDefaultValue</h3><pre class="programlisting">#define xmlSubstituteEntitiesDefaultValue</pre><p>
Global setting, indicate that the parser should not generate entity
references but replace them with the actual content of the entity
Disabled by default, this should be activated when using XPath since
the XPath data model requires entities replacement and the XPath
engine does not handle entities references transparently.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlRegisterNodeDefaultValue"></a>xmlRegisterNodeDefaultValue</h3><pre class="programlisting">#define xmlRegisterNodeDefaultValue</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlThrDefSubstituteEntitiesDefaultValue"></a>xmlThrDefSubstituteEntitiesDefaultValue ()</h3><pre class="programlisting">int xmlThrDefSubstituteEntitiesDefaultValue
(int v);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>v</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegisterNodeDefaultValue"></a>xmlRegisterNodeDefaultValue</h3><pre class="programlisting">#define xmlRegisterNodeDefaultValue</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlDeregisterNodeDefaultValue"></a>xmlDeregisterNodeDefaultValue</h3><pre class="programlisting">#define xmlDeregisterNodeDefaultValue</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-tree.html"><b>&lt;&lt; tree</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlexports.html"><b>xmlexports &gt;&gt;</b></a></td></tr></table></body></html>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-tree.html"><b>&lt;&lt; tree</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlunicode.html"><b>xmlunicode &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xpointer.html" title="xpointer"><link rel="next" href="libxml-relaxng.html" title="relaxng"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xpointer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-relaxng.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-hash"></a><div class="titlepage"></div><div class="refnamediv"><h2>hash</h2><p>hash &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2664516"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xpointer.html" title="xpointer"><link rel="next" href="libxml-nanohttp.html" title="nanohttp"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xpointer.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-nanohttp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-hash"></a><div class="titlepage"></div><div class="refnamediv"><h2>hash</h2><p>hash &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2625676"></a>Synopsis</h1></h2><pre class="synopsis">
@ -46,6 +46,93 @@ void (<a href="libxml-hash.html#xmlHashScannerFull">*xmlHashScannerFull</
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3);
<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> <a href="libxml-hash.html#xmlHashCreate">xmlHashCreate</a> (int size);
void <a href="libxml-hash.html#xmlHashFree">xmlHashFree</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);
int <a href="libxml-hash.html#xmlHashAddEntry">xmlHashAddEntry</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
void *userdata);
int <a href="libxml-hash.html#xmlHashUpdateEntry">xmlHashUpdateEntry</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
void *userdata,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);
int <a href="libxml-hash.html#xmlHashAddEntry2">xmlHashAddEntry2</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
void *userdata);
int <a href="libxml-hash.html#xmlHashUpdateEntry2">xmlHashUpdateEntry2</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
void *userdata,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);
int <a href="libxml-hash.html#xmlHashAddEntry3">xmlHashAddEntry3</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
void *userdata);
int <a href="libxml-hash.html#xmlHashUpdateEntry3">xmlHashUpdateEntry3</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
void *userdata,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);
int <a href="libxml-hash.html#xmlHashRemoveEntry">xmlHashRemoveEntry</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);
int <a href="libxml-hash.html#xmlHashRemoveEntry2">xmlHashRemoveEntry2</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);
int <a href="libxml-hash.html#xmlHashRemoveEntry3">xmlHashRemoveEntry3</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);
void* <a href="libxml-hash.html#xmlHashLookup">xmlHashLookup</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
void* <a href="libxml-hash.html#xmlHashLookup2">xmlHashLookup2</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2);
void* <a href="libxml-hash.html#xmlHashLookup3">xmlHashLookup3</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3);
void* <a href="libxml-hash.html#xmlHashQLookup">xmlHashQLookup</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);
void* <a href="libxml-hash.html#xmlHashQLookup2">xmlHashQLookup2</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix2);
void* <a href="libxml-hash.html#xmlHashQLookup3">xmlHashQLookup3</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix3);
<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> <a href="libxml-hash.html#xmlHashCopy">xmlHashCopy</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
<a href="libxml-hash.html#xmlHashCopier">xmlHashCopier</a> f);
int <a href="libxml-hash.html#xmlHashSize">xmlHashSize</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table);
void <a href="libxml-hash.html#xmlHashScan">xmlHashScan</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
<a href="libxml-hash.html#xmlHashScanner">xmlHashScanner</a> f,
void *data);
void <a href="libxml-hash.html#xmlHashScan3">xmlHashScan3</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
<a href="libxml-hash.html#xmlHashScanner">xmlHashScanner</a> f,
void *data);
void <a href="libxml-hash.html#xmlHashScanFull">xmlHashScanFull</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
<a href="libxml-hash.html#xmlHashScannerFull">xmlHashScannerFull</a> f,
void *data);
void <a href="libxml-hash.html#xmlHashScanFull3">xmlHashScanFull3</a> (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
<a href="libxml-hash.html#xmlHashScannerFull">xmlHashScannerFull</a> f,
void *data);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlHashTable"></a>struct xmlHashTable</h3><pre class="programlisting">struct xmlHashTable;</pre><p>
@ -85,4 +172,258 @@ Callback when scanning data in a hash with the full scanner.</p><p>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name associated
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> the second name associated
</td></tr><tr><td><span class="term"><i><tt>name3</tt></i>:</span></td><td> the third name associated
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xpointer.html"><b>&lt;&lt; xpointer</b></a></td><td align="right"><a accesskey="n" href="libxml-relaxng.html"><b>relaxng &gt;&gt;</b></a></td></tr></table></body></html>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashCreate"></a>xmlHashCreate ()</h3><pre class="programlisting"><a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> xmlHashCreate (int size);</pre><p>
Create a new xmlHashTablePtr.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the hash table
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object, or NULL if an error occured.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashFree"></a>xmlHashFree ()</h3><pre class="programlisting">void xmlHashFree (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);</pre><p>
Free the hash <i><tt>table</tt></i> and its contents. The userdata is
deallocated with <i><tt>f</tt></i> if provided.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the deallocator function for items in the hash
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashAddEntry"></a>xmlHashAddEntry ()</h3><pre class="programlisting">int xmlHashAddEntry (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
void *userdata);</pre><p>
Add the <i><tt>userdata</tt></i> to the hash <i><tt>table</tt></i>. This can later be retrieved
by using the <i><tt>name</tt></i>. Duplicate names generate errors.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>userdata</tt></i>:</span></td><td> a pointer to the userdata
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 the addition succeeded and -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashUpdateEntry"></a>xmlHashUpdateEntry ()</h3><pre class="programlisting">int xmlHashUpdateEntry (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
void *userdata,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);</pre><p>
Add the <i><tt>userdata</tt></i> to the hash <i><tt>table</tt></i>. This can later be retrieved
by using the <i><tt>name</tt></i>. Existing entry for this <i><tt>name</tt></i> will be removed
and freed with <i><tt>f</tt></i> if found.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>userdata</tt></i>:</span></td><td> a pointer to the userdata
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the deallocator function for replaced item (if any)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 the addition succeeded and -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashAddEntry2"></a>xmlHashAddEntry2 ()</h3><pre class="programlisting">int xmlHashAddEntry2 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
void *userdata);</pre><p>
Add the <i><tt>userdata</tt></i> to the hash <i><tt>table</tt></i>. This can later be retrieved
by using the (<i><tt>name</tt></i>, <i><tt>name2</tt></i>) tuple. Duplicate tuples generate errors.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>userdata</tt></i>:</span></td><td> a pointer to the userdata
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 the addition succeeded and -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashUpdateEntry2"></a>xmlHashUpdateEntry2 ()</h3><pre class="programlisting">int xmlHashUpdateEntry2 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
void *userdata,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);</pre><p>
Add the <i><tt>userdata</tt></i> to the hash <i><tt>table</tt></i>. This can later be retrieved
by using the (<i><tt>name</tt></i>, <i><tt>name2</tt></i>) tuple. Existing entry for this tuple will
be removed and freed with <i><tt>f</tt></i> if found.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>userdata</tt></i>:</span></td><td> a pointer to the userdata
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the deallocator function for replaced item (if any)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 the addition succeeded and -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashAddEntry3"></a>xmlHashAddEntry3 ()</h3><pre class="programlisting">int xmlHashAddEntry3 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
void *userdata);</pre><p>
Add the <i><tt>userdata</tt></i> to the hash <i><tt>table</tt></i>. This can later be retrieved
by using the tuple (<i><tt>name</tt></i>, <i><tt>name2</tt></i>, <i><tt>name3</tt></i>). Duplicate entries generate
errors.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name3</tt></i>:</span></td><td> a third name of the userdata
</td></tr><tr><td><span class="term"><i><tt>userdata</tt></i>:</span></td><td> a pointer to the userdata
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 the addition succeeded and -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashUpdateEntry3"></a>xmlHashUpdateEntry3 ()</h3><pre class="programlisting">int xmlHashUpdateEntry3 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
void *userdata,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);</pre><p>
Add the <i><tt>userdata</tt></i> to the hash <i><tt>table</tt></i>. This can later be retrieved
by using the tuple (<i><tt>name</tt></i>, <i><tt>name2</tt></i>, <i><tt>name3</tt></i>). Existing entry for this tuple
will be removed and freed with <i><tt>f</tt></i> if found.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name3</tt></i>:</span></td><td> a third name of the userdata
</td></tr><tr><td><span class="term"><i><tt>userdata</tt></i>:</span></td><td> a pointer to the userdata
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the deallocator function for replaced item (if any)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 the addition succeeded and -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashRemoveEntry"></a>xmlHashRemoveEntry ()</h3><pre class="programlisting">int xmlHashRemoveEntry (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);</pre><p>
Find the userdata specified by the <i><tt>name</tt></i> and remove
it from the hash <i><tt>table</tt></i>. Existing userdata for this tuple will be removed
and freed with <i><tt>f</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the deallocator function for removed item (if any)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if the removal succeeded and -1 in case of error or not found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashRemoveEntry2"></a>xmlHashRemoveEntry2 ()</h3><pre class="programlisting">int xmlHashRemoveEntry2 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);</pre><p>
Find the userdata specified by the (<i><tt>name</tt></i>, <i><tt>name2</tt></i>) tuple and remove
it from the hash <i><tt>table</tt></i>. Existing userdata for this tuple will be removed
and freed with <i><tt>f</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the deallocator function for removed item (if any)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if the removal succeeded and -1 in case of error or not found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashRemoveEntry3"></a>xmlHashRemoveEntry3 ()</h3><pre class="programlisting">int xmlHashRemoveEntry3 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
<a href="libxml-hash.html#xmlHashDeallocator">xmlHashDeallocator</a> f);</pre><p>
Find the userdata specified by the (<i><tt>name</tt></i>, <i><tt>name2</tt></i>, <i><tt>name3</tt></i>) tuple and remove
it from the hash <i><tt>table</tt></i>. Existing userdata for this tuple will be removed
and freed with <i><tt>f</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name3</tt></i>:</span></td><td> a third name of the userdata
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the deallocator function for removed item (if any)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if the removal succeeded and -1 in case of error or not found.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashLookup"></a>xmlHashLookup ()</h3><pre class="programlisting">void* xmlHashLookup (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Find the userdata specified by the <i><tt>name</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashLookup2"></a>xmlHashLookup2 ()</h3><pre class="programlisting">void* xmlHashLookup2 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2);</pre><p>
Find the userdata specified by the (<i><tt>name</tt></i>, <i><tt>name2</tt></i>) tuple.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashLookup3"></a>xmlHashLookup3 ()</h3><pre class="programlisting">void* xmlHashLookup3 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3);</pre><p>
Find the userdata specified by the (<i><tt>name</tt></i>, <i><tt>name2</tt></i>, <i><tt>name3</tt></i>) tuple.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>name3</tt></i>:</span></td><td> a third name of the userdata
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashQLookup"></a>xmlHashQLookup ()</h3><pre class="programlisting">void* xmlHashQLookup (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);</pre><p>
Find the userdata specified by the QName <i><tt>prefix</tt></i>:<i><tt>name</tt></i>/<i><tt>name</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the prefix of the userdata
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashQLookup2"></a>xmlHashQLookup2 ()</h3><pre class="programlisting">void* xmlHashQLookup2 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix2);</pre><p>
Find the userdata specified by the QNames tuple</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the prefix of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>prefix2</tt></i>:</span></td><td> the second prefix of the userdata
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashQLookup3"></a>xmlHashQLookup3 ()</h3><pre class="programlisting">void* xmlHashQLookup3 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix3);</pre><p>
Find the userdata specified by the (<i><tt>name</tt></i>, <i><tt>name2</tt></i>, <i><tt>name3</tt></i>) tuple.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the prefix of the userdata
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata
</td></tr><tr><td><span class="term"><i><tt>prefix2</tt></i>:</span></td><td> the second prefix of the userdata
</td></tr><tr><td><span class="term"><i><tt>name3</tt></i>:</span></td><td> a third name of the userdata
</td></tr><tr><td><span class="term"><i><tt>prefix3</tt></i>:</span></td><td> the third prefix of the userdata
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashCopy"></a>xmlHashCopy ()</h3><pre class="programlisting"><a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> xmlHashCopy (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
<a href="libxml-hash.html#xmlHashCopier">xmlHashCopier</a> f);</pre><p>
Scan the hash <i><tt>table</tt></i> and applied <i><tt>f</tt></i> to each value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the copier function for items in the hash
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new table or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashSize"></a>xmlHashSize ()</h3><pre class="programlisting">int xmlHashSize (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table);</pre><p>
Query the number of elements installed in the hash <i><tt>table</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of elements in the hash table or
-1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashScan"></a>xmlHashScan ()</h3><pre class="programlisting">void xmlHashScan (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
<a href="libxml-hash.html#xmlHashScanner">xmlHashScanner</a> f,
void *data);</pre><p>
Scan the hash <i><tt>table</tt></i> and applied <i><tt>f</tt></i> to each value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the scanner function for items in the hash
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> extra data passed to f
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashScan3"></a>xmlHashScan3 ()</h3><pre class="programlisting">void xmlHashScan3 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
<a href="libxml-hash.html#xmlHashScanner">xmlHashScanner</a> f,
void *data);</pre><p>
Scan the hash <i><tt>table</tt></i> and applied <i><tt>f</tt></i> to each value matching
(<i><tt>name</tt></i>, <i><tt>name2</tt></i>, <i><tt>name3</tt></i>) tuple. If one of the names is null,
the comparison is considered to match.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata or NULL
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata or NULL
</td></tr><tr><td><span class="term"><i><tt>name3</tt></i>:</span></td><td> a third name of the userdata or NULL
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the scanner function for items in the hash
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> extra data passed to f
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashScanFull"></a>xmlHashScanFull ()</h3><pre class="programlisting">void xmlHashScanFull (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
<a href="libxml-hash.html#xmlHashScannerFull">xmlHashScannerFull</a> f,
void *data);</pre><p>
Scan the hash <i><tt>table</tt></i> and applied <i><tt>f</tt></i> to each value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the scanner function for items in the hash
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> extra data passed to f
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlHashScanFull3"></a>xmlHashScanFull3 ()</h3><pre class="programlisting">void xmlHashScanFull3 (<a href="libxml-hash.html#xmlHashTablePtr">xmlHashTablePtr</a> table,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name2,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name3,
<a href="libxml-hash.html#xmlHashScannerFull">xmlHashScannerFull</a> f,
void *data);</pre><p>
Scan the hash <i><tt>table</tt></i> and applied <i><tt>f</tt></i> to each value matching
(<i><tt>name</tt></i>, <i><tt>name2</tt></i>, <i><tt>name3</tt></i>) tuple. If one of the names is null,
the comparison is considered to match.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> the hash table
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the userdata or NULL
</td></tr><tr><td><span class="term"><i><tt>name2</tt></i>:</span></td><td> a second name of the userdata or NULL
</td></tr><tr><td><span class="term"><i><tt>name3</tt></i>:</span></td><td> a third name of the userdata or NULL
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the scanner function for items in the hash
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> extra data passed to f
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xpointer.html"><b>&lt;&lt; xpointer</b></a></td><td align="right"><a accesskey="n" href="libxml-nanohttp.html"><b>nanohttp &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlversion.html" title="xmlversion"><link rel="next" href="libxml-HTMLtree.html" title="HTMLtree"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlversion.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-HTMLtree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>list</h2><p>list &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2701070"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlversion.html" title="xmlversion"><link rel="next" href="libxml-HTMLtree.html" title="HTMLtree"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlversion.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-HTMLtree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-list"></a><div class="titlepage"></div><div class="refnamediv"><h2>list</h2><p>list &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2635080"></a>Synopsis</h1></h2><pre class="synopsis">
@ -41,6 +41,48 @@ int (<a href="libxml-list.html#xmlListDataCompare">*xmlListDataCompare</
const void *data1);
int (<a href="libxml-list.html#xmlListWalker">*xmlListWalker</a>) (const void *data,
const void *user);
<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> <a href="libxml-list.html#xmlListCreate">xmlListCreate</a> (<a href="libxml-list.html#xmlListDeallocator">xmlListDeallocator</a> deallocator,
<a href="libxml-list.html#xmlListDataCompare">xmlListDataCompare</a> compare);
void <a href="libxml-list.html#xmlListDelete">xmlListDelete</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
void* <a href="libxml-list.html#xmlListSearch">xmlListSearch</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
void* <a href="libxml-list.html#xmlListReverseSearch">xmlListReverseSearch</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
int <a href="libxml-list.html#xmlListInsert">xmlListInsert</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
int <a href="libxml-list.html#xmlListAppend">xmlListAppend</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
int <a href="libxml-list.html#xmlListRemoveFirst">xmlListRemoveFirst</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
int <a href="libxml-list.html#xmlListRemoveLast">xmlListRemoveLast</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
int <a href="libxml-list.html#xmlListRemoveAll">xmlListRemoveAll</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
void <a href="libxml-list.html#xmlListClear">xmlListClear</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
int <a href="libxml-list.html#xmlListEmpty">xmlListEmpty</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
<a href="libxml-list.html#xmlLinkPtr">xmlLinkPtr</a> <a href="libxml-list.html#xmlListFront">xmlListFront</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
<a href="libxml-list.html#xmlLinkPtr">xmlLinkPtr</a> <a href="libxml-list.html#xmlListEnd">xmlListEnd</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
int <a href="libxml-list.html#xmlListSize">xmlListSize</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
void <a href="libxml-list.html#xmlListPopFront">xmlListPopFront</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
void <a href="libxml-list.html#xmlListPopBack">xmlListPopBack</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
int <a href="libxml-list.html#xmlListPushFront">xmlListPushFront</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
int <a href="libxml-list.html#xmlListPushBack">xmlListPushBack</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);
void <a href="libxml-list.html#xmlListReverse">xmlListReverse</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
void <a href="libxml-list.html#xmlListSort">xmlListSort</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);
void <a href="libxml-list.html#xmlListWalk">xmlListWalk</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
<a href="libxml-list.html#xmlListWalker">xmlListWalker</a> walker,
const void *user);
void <a href="libxml-list.html#xmlListReverseWalk">xmlListReverseWalk</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
<a href="libxml-list.html#xmlListWalker">xmlListWalker</a> walker,
const void *user);
void <a href="libxml-list.html#xmlListMerge">xmlListMerge</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l1,
<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l2);
<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> <a href="libxml-list.html#xmlListDup">xmlListDup</a> (const <a href="libxml-list.html#xmlListPtr">xmlListPtr</a> old);
int <a href="libxml-list.html#xmlListCopy">xmlListCopy</a> (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> cur,
const <a href="libxml-list.html#xmlListPtr">xmlListPtr</a> old);
void* <a href="libxml-list.html#xmlLinkGetData">xmlLinkGetData</a> (<a href="libxml-list.html#xmlLinkPtr">xmlLinkPtr</a> lk);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlLink"></a>struct xmlLink</h3><pre class="programlisting">struct xmlLink;</pre><p>
@ -66,9 +108,162 @@ Callback function used to compare 2 data.</p><p>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 is equality, -1 or 1 otherwise depending on the ordering.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListWalker"></a>xmlListWalker ()</h3><pre class="programlisting">int (*xmlListWalker) (const void *data,
const void *user);</pre><p>
Callback function used when walking a list with <GTKDOCLINK HREF="xmlListWalk">xmlListWalk</GTKDOCLINK>().</p><p>
Callback function used when walking a list with <a href="libxml-list.html#xmlListWalk">xmlListWalk</a>().</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> the data found in the list
</td></tr><tr><td><span class="term"><i><tt>user</tt></i>:</span></td><td> extra user provided data to the walker
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 to stop walking the list, 1 otherwise.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListCreate"></a>xmlListCreate ()</h3><pre class="programlisting"><a href="libxml-list.html#xmlListPtr">xmlListPtr</a> xmlListCreate (<a href="libxml-list.html#xmlListDeallocator">xmlListDeallocator</a> deallocator,
<a href="libxml-list.html#xmlListDataCompare">xmlListDataCompare</a> compare);</pre><p>
Create a new list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>deallocator</tt></i>:</span></td><td> an optional deallocator function
</td></tr><tr><td><span class="term"><i><tt>compare</tt></i>:</span></td><td> an optional comparison function
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new list or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListDelete"></a>xmlListDelete ()</h3><pre class="programlisting">void xmlListDelete (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Deletes the list and its associated data</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListSearch"></a>xmlListSearch ()</h3><pre class="programlisting">void* xmlListSearch (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
Search the list for an existing value of <i><tt>data</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> a search value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListReverseSearch"></a>xmlListReverseSearch ()</h3><pre class="programlisting">void* xmlListReverseSearch (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
Search the list in reverse order for an existing value of <i><tt>data</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> a search value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListInsert"></a>xmlListInsert ()</h3><pre class="programlisting">int xmlListInsert (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
Insert data in the ordered list at the beginning for this value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> the data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success, 1 in case of failure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListAppend"></a>xmlListAppend ()</h3><pre class="programlisting">int xmlListAppend (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
Insert data in the ordered list at the end for this value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> the data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success, 1 in case of failure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListRemoveFirst"></a>xmlListRemoveFirst ()</h3><pre class="programlisting">int xmlListRemoveFirst (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
Remove the first instance associated to data in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> list data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if a deallocation occured, or 0 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListRemoveLast"></a>xmlListRemoveLast ()</h3><pre class="programlisting">int xmlListRemoveLast (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
Remove the last instance associated to data in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> list data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if a deallocation occured, or 0 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListRemoveAll"></a>xmlListRemoveAll ()</h3><pre class="programlisting">int xmlListRemoveAll (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
Remove the all instance associated to data in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> list data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of deallocation, or 0 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListClear"></a>xmlListClear ()</h3><pre class="programlisting">void xmlListClear (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Remove the all data in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListEmpty"></a>xmlListEmpty ()</h3><pre class="programlisting">int xmlListEmpty (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Is the list empty ?</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if the list is empty, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListFront"></a>xmlListFront ()</h3><pre class="programlisting"><a href="libxml-list.html#xmlLinkPtr">xmlLinkPtr</a> xmlListFront (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Get the first element in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the first element in the list, or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListEnd"></a>xmlListEnd ()</h3><pre class="programlisting"><a href="libxml-list.html#xmlLinkPtr">xmlLinkPtr</a> xmlListEnd (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Get the last element in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the last element in the list, or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListSize"></a>xmlListSize ()</h3><pre class="programlisting">int xmlListSize (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Get the number of elements in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of elements in the list
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListPopFront"></a>xmlListPopFront ()</h3><pre class="programlisting">void xmlListPopFront (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Removes the first element in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListPopBack"></a>xmlListPopBack ()</h3><pre class="programlisting">void xmlListPopBack (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Removes the last element in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListPushFront"></a>xmlListPushFront ()</h3><pre class="programlisting">int xmlListPushFront (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
add the new data at the beginning of the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> new data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if successful, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListPushBack"></a>xmlListPushBack ()</h3><pre class="programlisting">int xmlListPushBack (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
void *data);</pre><p>
add the new data at the end of the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> new data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if successful, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListReverse"></a>xmlListReverse ()</h3><pre class="programlisting">void xmlListReverse (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Reverse the order of the elements in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListSort"></a>xmlListSort ()</h3><pre class="programlisting">void xmlListSort (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l);</pre><p>
Sort all the elements in the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListWalk"></a>xmlListWalk ()</h3><pre class="programlisting">void xmlListWalk (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
<a href="libxml-list.html#xmlListWalker">xmlListWalker</a> walker,
const void *user);</pre><p>
Walk all the element of the first from first to last and
apply the walker function to it</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>walker</tt></i>:</span></td><td> a processing function
</td></tr><tr><td><span class="term"><i><tt>user</tt></i>:</span></td><td> a user parameter passed to the walker function
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListReverseWalk"></a>xmlListReverseWalk ()</h3><pre class="programlisting">void xmlListReverseWalk (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l,
<a href="libxml-list.html#xmlListWalker">xmlListWalker</a> walker,
const void *user);</pre><p>
Walk all the element of the list in reverse order and
apply the walker function to it</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l</tt></i>:</span></td><td> a list
</td></tr><tr><td><span class="term"><i><tt>walker</tt></i>:</span></td><td> a processing function
</td></tr><tr><td><span class="term"><i><tt>user</tt></i>:</span></td><td> a user parameter passed to the walker function
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListMerge"></a>xmlListMerge ()</h3><pre class="programlisting">void xmlListMerge (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l1,
<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> l2);</pre><p>
include all the elements of the second list in the first one and
clear the second list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>l1</tt></i>:</span></td><td> the original list
</td></tr><tr><td><span class="term"><i><tt>l2</tt></i>:</span></td><td> the new list
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListDup"></a>xmlListDup ()</h3><pre class="programlisting"><a href="libxml-list.html#xmlListPtr">xmlListPtr</a> xmlListDup (const <a href="libxml-list.html#xmlListPtr">xmlListPtr</a> old);</pre><p>
Duplicate the list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>old</tt></i>:</span></td><td> the list
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new copy of the list or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlListCopy"></a>xmlListCopy ()</h3><pre class="programlisting">int xmlListCopy (<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> cur,
const <a href="libxml-list.html#xmlListPtr">xmlListPtr</a> old);</pre><p>
Move all the element from the old list in the new list</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the new list
</td></tr><tr><td><span class="term"><i><tt>old</tt></i>:</span></td><td> the old list
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success 1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlLinkGetData"></a>xmlLinkGetData ()</h3><pre class="programlisting">void* xmlLinkGetData (<a href="libxml-list.html#xmlLinkPtr">xmlLinkPtr</a> lk);</pre><p>
See Returns.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>lk</tt></i>:</span></td><td> a link
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlversion.html"><b>&lt;&lt; xmlversion</b></a></td><td align="right"><a accesskey="n" href="libxml-HTMLtree.html"><b>HTMLtree &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-uri.html" title="uri"><link rel="next" href="libxml-schemasInternals.html" title="schemasInternals"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-uri.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-schemasInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-nanoftp"></a><div class="titlepage"></div><div class="refnamediv"><h2>nanoftp</h2><p>nanoftp &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2685647"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-SAX2.html" title="SAX2"><link rel="next" href="libxml-schemasInternals.html" title="schemasInternals"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-SAX2.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-schemasInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-nanoftp"></a><div class="titlepage"></div><div class="refnamediv"><h2>nanoftp</h2><p>nanoftp &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2690152"></a>Synopsis</h1></h2><pre class="synopsis">
@ -47,6 +47,45 @@ void (<a href="libxml-nanoftp.html#ftpListCallback">*ftpListCallback</a>)
void (<a href="libxml-nanoftp.html#ftpDataCallback">*ftpDataCallback</a>) (void *userData,
const char *data,
int len);
void <a href="libxml-nanoftp.html#xmlNanoFTPInit">xmlNanoFTPInit</a> (void);
void <a href="libxml-nanoftp.html#xmlNanoFTPCleanup">xmlNanoFTPCleanup</a> (void);
void* <a href="libxml-nanoftp.html#xmlNanoFTPNewCtxt">xmlNanoFTPNewCtxt</a> (const char *URL);
void <a href="libxml-nanoftp.html#xmlNanoFTPFreeCtxt">xmlNanoFTPFreeCtxt</a> (void *ctx);
void* <a href="libxml-nanoftp.html#xmlNanoFTPConnectTo">xmlNanoFTPConnectTo</a> (const char *server,
int port);
void* <a href="libxml-nanoftp.html#xmlNanoFTPOpen">xmlNanoFTPOpen</a> (const char *URL);
int <a href="libxml-nanoftp.html#xmlNanoFTPConnect">xmlNanoFTPConnect</a> (void *ctx);
int <a href="libxml-nanoftp.html#xmlNanoFTPClose">xmlNanoFTPClose</a> (void *ctx);
int <a href="libxml-nanoftp.html#xmlNanoFTPQuit">xmlNanoFTPQuit</a> (void *ctx);
void <a href="libxml-nanoftp.html#xmlNanoFTPScanProxy">xmlNanoFTPScanProxy</a> (const char *URL);
void <a href="libxml-nanoftp.html#xmlNanoFTPProxy">xmlNanoFTPProxy</a> (const char *host,
int port,
const char *user,
const char *passwd,
int type);
int <a href="libxml-nanoftp.html#xmlNanoFTPUpdateURL">xmlNanoFTPUpdateURL</a> (void *ctx,
const char *URL);
int <a href="libxml-nanoftp.html#xmlNanoFTPGetResponse">xmlNanoFTPGetResponse</a> (void *ctx);
int <a href="libxml-nanoftp.html#xmlNanoFTPCheckResponse">xmlNanoFTPCheckResponse</a> (void *ctx);
int <a href="libxml-nanoftp.html#xmlNanoFTPCwd">xmlNanoFTPCwd</a> (void *ctx,
char *directory);
int <a href="libxml-nanoftp.html#xmlNanoFTPDele">xmlNanoFTPDele</a> (void *ctx,
char *file);
int <a href="libxml-nanoftp.html#xmlNanoFTPGetConnection">xmlNanoFTPGetConnection</a> (void *ctx);
int <a href="libxml-nanoftp.html#xmlNanoFTPCloseConnection">xmlNanoFTPCloseConnection</a> (void *ctx);
int <a href="libxml-nanoftp.html#xmlNanoFTPList">xmlNanoFTPList</a> (void *ctx,
<a href="libxml-nanoftp.html#ftpListCallback">ftpListCallback</a> callback,
void *userData,
char *filename);
int <a href="libxml-nanoftp.html#xmlNanoFTPGetSocket">xmlNanoFTPGetSocket</a> (void *ctx,
const char *filename);
int <a href="libxml-nanoftp.html#xmlNanoFTPGet">xmlNanoFTPGet</a> (void *ctx,
<a href="libxml-nanoftp.html#ftpDataCallback">ftpDataCallback</a> callback,
void *userData,
const char *filename);
int <a href="libxml-nanoftp.html#xmlNanoFTPRead">xmlNanoFTPRead</a> (void *ctx,
void *dest,
int len);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="ftpListCallback"></a>ftpListCallback ()</h3><pre class="programlisting">void (*ftpListCallback) (void *userData,
@ -84,4 +123,154 @@ A callback for the xmlNanoFTPGet command.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> the user provided context
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> the data received
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> its size in bytes
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-uri.html"><b>&lt;&lt; uri</b></a></td><td align="right"><a accesskey="n" href="libxml-schemasInternals.html"><b>schemasInternals &gt;&gt;</b></a></td></tr></table></body></html>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPInit"></a>xmlNanoFTPInit ()</h3><pre class="programlisting">void xmlNanoFTPInit (void);</pre><p>
Initialize the FTP protocol layer.
Currently it just checks for proxy informations,
and get the hostname</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPCleanup"></a>xmlNanoFTPCleanup ()</h3><pre class="programlisting">void xmlNanoFTPCleanup (void);</pre><p>
Cleanup the FTP protocol layer. This cleanup proxy informations.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPNewCtxt"></a>xmlNanoFTPNewCtxt ()</h3><pre class="programlisting">void* xmlNanoFTPNewCtxt (const char *URL);</pre><p>
Allocate and initialize a new FTP context.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The URL used to initialize the context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPFreeCtxt"></a>xmlNanoFTPFreeCtxt ()</h3><pre class="programlisting">void xmlNanoFTPFreeCtxt (void *ctx);</pre><p>
Frees the context after closing the connection.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPConnectTo"></a>xmlNanoFTPConnectTo ()</h3><pre class="programlisting">void* xmlNanoFTPConnectTo (const char *server,
int port);</pre><p>
Tries to open a control connection to the given server/port</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>server</tt></i>:</span></td><td> an FTP server name
</td></tr><tr><td><span class="term"><i><tt>port</tt></i>:</span></td><td> the port (use 21 if 0)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPOpen"></a>xmlNanoFTPOpen ()</h3><pre class="programlisting">void* xmlNanoFTPOpen (const char *URL);</pre><p>
Start to fetch the given ftp:// resource</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the URL to the resource
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPConnect"></a>xmlNanoFTPConnect ()</h3><pre class="programlisting">int xmlNanoFTPConnect (void *ctx);</pre><p>
Tries to open a control connection</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 in case of error, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPClose"></a>xmlNanoFTPClose ()</h3><pre class="programlisting">int xmlNanoFTPClose (void *ctx);</pre><p>
Close the connection and both control and transport</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 incase of error, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPQuit"></a>xmlNanoFTPQuit ()</h3><pre class="programlisting">int xmlNanoFTPQuit (void *ctx);</pre><p>
Send a QUIT command to the server</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 in case of error, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPScanProxy"></a>xmlNanoFTPScanProxy ()</h3><pre class="programlisting">void xmlNanoFTPScanProxy (const char *URL);</pre><p>
(Re)Initialize the FTP Proxy context by parsing the URL and finding
the protocol host port it indicates.
Should be like ftp://myproxy/ or ftp://myproxy:3128/
A NULL URL cleans up proxy informations.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The proxy URL used to initialize the proxy context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPProxy"></a>xmlNanoFTPProxy ()</h3><pre class="programlisting">void xmlNanoFTPProxy (const char *host,
int port,
const char *user,
const char *passwd,
int type);</pre><p>
Setup the FTP proxy informations.
This can also be done by using ftp_proxy ftp_proxy_user and
ftp_proxy_password environment variables.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>host</tt></i>:</span></td><td> the proxy host name
</td></tr><tr><td><span class="term"><i><tt>port</tt></i>:</span></td><td> the proxy port
</td></tr><tr><td><span class="term"><i><tt>user</tt></i>:</span></td><td> the proxy user name
</td></tr><tr><td><span class="term"><i><tt>passwd</tt></i>:</span></td><td> the proxy password
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the type of proxy 1 for using SITE, 2 for USER a<i><tt>b</tt></i>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPUpdateURL"></a>xmlNanoFTPUpdateURL ()</h3><pre class="programlisting">int xmlNanoFTPUpdateURL (void *ctx,
const char *URL);</pre><p>
Update an FTP context by parsing the URL and finding
new path it indicates. If there is an error in the
protocol, hostname, port or other information, the
error is raised. It indicates a new connection has to
be established.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The URL used to update the context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if Ok, -1 in case of error (other host).
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPGetResponse"></a>xmlNanoFTPGetResponse ()</h3><pre class="programlisting">int xmlNanoFTPGetResponse (void *ctx);</pre><p>
Get the response from the FTP server after a command.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the code number
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPCheckResponse"></a>xmlNanoFTPCheckResponse ()</h3><pre class="programlisting">int xmlNanoFTPCheckResponse (void *ctx);</pre><p>
Check if there is a response from the FTP server after a command.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the code number, or 0
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPCwd"></a>xmlNanoFTPCwd ()</h3><pre class="programlisting">int xmlNanoFTPCwd (void *ctx,
char *directory);</pre><p>
Tries to change the remote directory</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><i><tt>directory</tt></i>:</span></td><td> a directory on the server
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 incase of error, 1 if CWD worked, 0 if it failed
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPDele"></a>xmlNanoFTPDele ()</h3><pre class="programlisting">int xmlNanoFTPDele (void *ctx,
char *file);</pre><p>
Tries to delete an item (file or directory) from server</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><i><tt>file</tt></i>:</span></td><td> a file or directory on the server
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 incase of error, 1 if DELE worked, 0 if it failed
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPGetConnection"></a>xmlNanoFTPGetConnection ()</h3><pre class="programlisting">int xmlNanoFTPGetConnection (void *ctx);</pre><p>
Try to open a data connection to the server. Currently only
passive mode is supported.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 incase of error, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPCloseConnection"></a>xmlNanoFTPCloseConnection ()</h3><pre class="programlisting">int xmlNanoFTPCloseConnection (void *ctx);</pre><p>
Close the data connection from the server</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 incase of error, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPList"></a>xmlNanoFTPList ()</h3><pre class="programlisting">int xmlNanoFTPList (void *ctx,
<a href="libxml-nanoftp.html#ftpListCallback">ftpListCallback</a> callback,
void *userData,
char *filename);</pre><p>
Do a listing on the server. All files info are passed back
in the callbacks.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><i><tt>callback</tt></i>:</span></td><td> the user callback
</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> the user callback data
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> optional files to list
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 incase of error, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPGetSocket"></a>xmlNanoFTPGetSocket ()</h3><pre class="programlisting">int xmlNanoFTPGetSocket (void *ctx,
const char *filename);</pre><p>
Initiate fetch of the given file from the server.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the file to retrieve (or NULL if path is in context).
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the socket for the data connection, or &lt;0 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPGet"></a>xmlNanoFTPGet ()</h3><pre class="programlisting">int xmlNanoFTPGet (void *ctx,
<a href="libxml-nanoftp.html#ftpDataCallback">ftpDataCallback</a> callback,
void *userData,
const char *filename);</pre><p>
Fetch the given file from the server. All data are passed back
in the callbacks. The last callback has a size of 0 block.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an FTP context
</td></tr><tr><td><span class="term"><i><tt>callback</tt></i>:</span></td><td> the user callback
</td></tr><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> the user callback data
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the file to retrieve
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 incase of error, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoFTPRead"></a>xmlNanoFTPRead ()</h3><pre class="programlisting">int xmlNanoFTPRead (void *ctx,
void *dest,
int len);</pre><p>
This function tries to read <i><tt>len</tt></i> bytes from the existing FTP connection
and saves them in <i><tt>dest</tt></i>. This is a blocking call.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the FTP context
</td></tr><tr><td><span class="term"><i><tt>dest</tt></i>:</span></td><td> a buffer
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the buffer length
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte read. 0 is an indication of an end of connection.
-1 indicates a parameter error.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-SAX2.html"><b>&lt;&lt; SAX2</b></a></td><td align="right"><a accesskey="n" href="libxml-schemasInternals.html"><b>schemasInternals &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -1,4 +1,4 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>nanohttp</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>nanohttp</title><meta name="generator" content="DocBook XSL Stylesheets V1.48"><meta name="generator" content="GTK-Doc V1.1 (XML mode)"><style type="text/css">
.synopsis, .classsynopsis {
background: #eeeeee;
border: solid 1px #aaaaaa;
@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="libxml-lib.html" title="Libxml Library Reference"><link rel="previous" href="libxml-xinclude.html" title="xinclude"><link rel="next" href="libxml-nanoftp.html" title="nanoftp"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xinclude.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></img></a></td><td><a accesskey="u" href="libxml-lib.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></img></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></img></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-nanoftp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></img></a></td></tr></table><div class="refentry" lang="en"><a name="libxml-nanohttp"></a><div class="titlepage"></div><div class="refnamediv"><h2>nanohttp</h2><p>nanohttp &#8212; </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-hash.html" title="hash"><link rel="next" href="libxml-relaxng.html" title="relaxng"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-hash.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-relaxng.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-nanohttp"></a><div class="titlepage"></div><div class="refnamediv"><h2>nanohttp</h2><p>nanohttp &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2777439"></a>Synopsis</h1></h2><pre class="synopsis">
@ -58,41 +58,44 @@ void* <a href="libxml-nanohttp.html#xmlNanoHTTPOpenRedir">xmlNanoHTTPOpenR
char **redir);
int <a href="libxml-nanohttp.html#xmlNanoHTTPReturnCode">xmlNanoHTTPReturnCode</a> (void *ctx);
const char* <a href="libxml-nanohttp.html#xmlNanoHTTPAuthHeader">xmlNanoHTTPAuthHeader</a> (void *ctx);
const char* <a href="libxml-nanohttp.html#xmlNanoHTTPRedir">xmlNanoHTTPRedir</a> (void *ctx);
const char* <a href="libxml-nanohttp.html#xmlNanoHTTPEncoding">xmlNanoHTTPEncoding</a> (void *ctx);
const char* <a href="libxml-nanohttp.html#xmlNanoHTTPMimeType">xmlNanoHTTPMimeType</a> (void *ctx);
int <a href="libxml-nanohttp.html#xmlNanoHTTPRead">xmlNanoHTTPRead</a> (void *ctx,
void *dest,
int len);
int <a href="libxml-nanohttp.html#xmlNanoHTTPSave">xmlNanoHTTPSave</a> (void *ctxt,
const char *filename);
void <a href="libxml-nanohttp.html#xmlNanoHTTPClose">xmlNanoHTTPClose</a> (void *ctx);
</pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPInit"></a>xmlNanoHTTPInit ()</h3><pre class="programlisting">void xmlNanoHTTPInit (void);</pre><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlNanoHTTPInit"></a>xmlNanoHTTPInit ()</h3><pre class="programlisting">void xmlNanoHTTPInit (void);</pre><p>
Initialize the HTTP protocol layer.
Currently it just checks for proxy informations</p><p>
</p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPCleanup"></a>xmlNanoHTTPCleanup ()</h3><pre class="programlisting">void xmlNanoHTTPCleanup (void);</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPCleanup"></a>xmlNanoHTTPCleanup ()</h3><pre class="programlisting">void xmlNanoHTTPCleanup (void);</pre><p>
Cleanup the HTTP protocol layer.</p><p>
</p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPScanProxy"></a>xmlNanoHTTPScanProxy ()</h3><pre class="programlisting">void xmlNanoHTTPScanProxy (const char *URL);</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPScanProxy"></a>xmlNanoHTTPScanProxy ()</h3><pre class="programlisting">void xmlNanoHTTPScanProxy (const char *URL);</pre><p>
(Re)Initialize the HTTP Proxy context by parsing the URL and finding
the protocol host port it indicates.
Should be like http://myproxy/ or http://myproxy:3128/
A NULL URL cleans up proxy informations.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>URL</tt></i> :</span></td><td> The proxy URL used to initialize the proxy context
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPFetch"></a>xmlNanoHTTPFetch ()</h3><pre class="programlisting">int xmlNanoHTTPFetch (const char *URL,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The proxy URL used to initialize the proxy context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPFetch"></a>xmlNanoHTTPFetch ()</h3><pre class="programlisting">int xmlNanoHTTPFetch (const char *URL,
const char *filename,
char **contentType);</pre><p>
This function try to fetch the indicated resource via HTTP GET
and save it's content in the file.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>URL</tt></i> :</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i> :</span></td><td> the filename where the content should be saved
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i> :</span></td><td> if available the Content-Type information will be
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename where the content should be saved
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i>:</span></td><td> if available the Content-Type information will be
returned at that location
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>-1 in case of failure, 0 incase of success. The contentType,
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 in case of failure, 0 incase of success. The contentType,
if provided must be freed by the caller
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPMethod"></a>xmlNanoHTTPMethod ()</h3><pre class="programlisting">void* xmlNanoHTTPMethod (const char *URL,
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPMethod"></a>xmlNanoHTTPMethod ()</h3><pre class="programlisting">void* xmlNanoHTTPMethod (const char *URL,
const char *method,
const char *input,
char **contentType,
@ -102,13 +105,13 @@ This function try to open a connection to the indicated resource
via HTTP using the given <i><tt>method</tt></i>, adding the given extra headers
and the input buffer for the request content.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>URL</tt></i> :</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>method</tt></i> :</span></td><td> the HTTP method to use
</td></tr><tr><td><span class="term"><i><tt>input</tt></i> :</span></td><td> the input string if any
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i> :</span></td><td> the Content-Type information IN and OUT
</td></tr><tr><td><span class="term"><i><tt>headers</tt></i> :</span></td><td> the extra headers
</td></tr><tr><td><span class="term"><i><tt>ilen</tt></i> :</span></td><td> input length
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPMethodRedir"></a>xmlNanoHTTPMethodRedir ()</h3><pre class="programlisting">void* xmlNanoHTTPMethodRedir (const char *URL,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>method</tt></i>:</span></td><td> the HTTP method to use
</td></tr><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> the input string if any
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i>:</span></td><td> the Content-Type information IN and OUT
</td></tr><tr><td><span class="term"><i><tt>headers</tt></i>:</span></td><td> the extra headers
</td></tr><tr><td><span class="term"><i><tt>ilen</tt></i>:</span></td><td> input length
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPMethodRedir"></a>xmlNanoHTTPMethodRedir ()</h3><pre class="programlisting">void* xmlNanoHTTPMethodRedir (const char *URL,
const char *method,
const char *input,
char **contentType,
@ -119,64 +122,91 @@ This function try to open a connection to the indicated resource
via HTTP using the given <i><tt>method</tt></i>, adding the given extra headers
and the input buffer for the request content.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>URL</tt></i> :</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>method</tt></i> :</span></td><td> the HTTP method to use
</td></tr><tr><td><span class="term"><i><tt>input</tt></i> :</span></td><td> the input string if any
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i> :</span></td><td> the Content-Type information IN and OUT
</td></tr><tr><td><span class="term"><i><tt>redir</tt></i> :</span></td><td> the redirected URL OUT
</td></tr><tr><td><span class="term"><i><tt>headers</tt></i> :</span></td><td> the extra headers
</td></tr><tr><td><span class="term"><i><tt>ilen</tt></i> :</span></td><td> input length
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPOpen"></a>xmlNanoHTTPOpen ()</h3><pre class="programlisting">void* xmlNanoHTTPOpen (const char *URL,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>method</tt></i>:</span></td><td> the HTTP method to use
</td></tr><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> the input string if any
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i>:</span></td><td> the Content-Type information IN and OUT
</td></tr><tr><td><span class="term"><i><tt>redir</tt></i>:</span></td><td> the redirected URL OUT
</td></tr><tr><td><span class="term"><i><tt>headers</tt></i>:</span></td><td> the extra headers
</td></tr><tr><td><span class="term"><i><tt>ilen</tt></i>:</span></td><td> input length
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPOpen"></a>xmlNanoHTTPOpen ()</h3><pre class="programlisting">void* xmlNanoHTTPOpen (const char *URL,
char **contentType);</pre><p>
This function try to open a connection to the indicated resource
via HTTP GET.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>URL</tt></i> :</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i> :</span></td><td> if available the Content-Type information will be
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i>:</span></td><td> if available the Content-Type information will be
returned at that location
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPOpenRedir"></a>xmlNanoHTTPOpenRedir ()</h3><pre class="programlisting">void* xmlNanoHTTPOpenRedir (const char *URL,
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPOpenRedir"></a>xmlNanoHTTPOpenRedir ()</h3><pre class="programlisting">void* xmlNanoHTTPOpenRedir (const char *URL,
char **contentType,
char **redir);</pre><p>
This function try to open a connection to the indicated resource
via HTTP GET.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>URL</tt></i> :</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i> :</span></td><td> if available the Content-Type information will be
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> The URL to load
</td></tr><tr><td><span class="term"><i><tt>contentType</tt></i>:</span></td><td> if available the Content-Type information will be
returned at that location
</td></tr><tr><td><span class="term"><i><tt>redir</tt></i> :</span></td><td> if available the redirected URL will be returned
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPReturnCode"></a>xmlNanoHTTPReturnCode ()</h3><pre class="programlisting">int xmlNanoHTTPReturnCode (void *ctx);</pre><p>
</td></tr><tr><td><span class="term"><i><tt>redir</tt></i>:</span></td><td> if available the redirected URL will be returned
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPReturnCode"></a>xmlNanoHTTPReturnCode ()</h3><pre class="programlisting">int xmlNanoHTTPReturnCode (void *ctx);</pre><p>
Get the latest HTTP return code received</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the HTTP return code for the request.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPAuthHeader"></a>xmlNanoHTTPAuthHeader ()</h3><pre class="programlisting">const char* xmlNanoHTTPAuthHeader (void *ctx);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the HTTP return code for the request.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPAuthHeader"></a>xmlNanoHTTPAuthHeader ()</h3><pre class="programlisting">const char* xmlNanoHTTPAuthHeader (void *ctx);</pre><p>
Get the authentication header of an HTTP context</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the stashed value of the WWW-Authenticate or Proxy-Authenticate
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the stashed value of the WWW-Authenticate or Proxy-Authenticate
header.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPRead"></a>xmlNanoHTTPRead ()</h3><pre class="programlisting">int xmlNanoHTTPRead (void *ctx,
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPRedir"></a>xmlNanoHTTPRedir ()</h3><pre class="programlisting">const char* xmlNanoHTTPRedir (void *ctx);</pre><p>
Provides the specified redirection URL if available from the HTTP header.
</p><p>
Return the specified redirection URL or NULL if not redirected.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPEncoding"></a>xmlNanoHTTPEncoding ()</h3><pre class="programlisting">const char* xmlNanoHTTPEncoding (void *ctx);</pre><p>
Provides the specified encoding if specified in the HTTP headers.
</p><p>
Return the specified encoding or NULL if not available</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPMimeType"></a>xmlNanoHTTPMimeType ()</h3><pre class="programlisting">const char* xmlNanoHTTPMimeType (void *ctx);</pre><p>
Provides the specified Mime-Type if specified in the HTTP headers.
</p><p>
Return the specified Mime-Type or NULL if not available</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPRead"></a>xmlNanoHTTPRead ()</h3><pre class="programlisting">int xmlNanoHTTPRead (void *ctx,
void *dest,
int len);</pre><p>
This function tries to read <i><tt>len</tt></i> bytes from the existing HTTP connection
and saves them in <i><tt>dest</tt></i>. This is a blocking call.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><i><tt>dest</tt></i> :</span></td><td> a buffer
</td></tr><tr><td><span class="term"><i><tt>len</tt></i> :</span></td><td> the buffer length
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the number of byte read. 0 is an indication of an end of connection.
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><i><tt>dest</tt></i>:</span></td><td> a buffer
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the buffer length
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte read. 0 is an indication of an end of connection.
-1 indicates a parameter error.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPSave"></a>xmlNanoHTTPSave ()</h3><pre class="programlisting">int xmlNanoHTTPSave (void *ctxt,
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPSave"></a>xmlNanoHTTPSave ()</h3><pre class="programlisting">int xmlNanoHTTPSave (void *ctxt,
const char *filename);</pre><p>
This function saves the output of the HTTP transaction to a file
It closes and free the context at the end</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i> :</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i> :</span></td><td> the filename where the content should be saved
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>-1 in case of failure, 0 incase of success.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlNanoHTTPClose"></a>xmlNanoHTTPClose ()</h3><pre class="programlisting">void xmlNanoHTTPClose (void *ctx);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the HTTP context
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the filename where the content should be saved
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 in case of failure, 0 incase of success.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNanoHTTPClose"></a>xmlNanoHTTPClose ()</h3><pre class="programlisting">void xmlNanoHTTPClose (void *ctx);</pre><p>
This function closes an HTTP context, it ends up the connection and
free all data related to it.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i> :</span></td><td> the HTTP context
</td></tr></tbody></table></div></div></div></div><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xinclude.html"><b>&lt;&lt; xinclude</b></a></td><td align="right"><a accesskey="n" href="libxml-nanoftp.html"><b>nanoftp &gt;&gt;</b></a></td></tr></table></body></html>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the HTTP context
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-hash.html"><b>&lt;&lt; hash</b></a></td><td align="right"><a accesskey="n" href="libxml-relaxng.html"><b>relaxng &gt;&gt;</b></a></td></tr></table></body></html>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-hash.html" title="hash"><link rel="next" href="libxml-xpathInternals.html" title="xpathInternals"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-hash.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xpathInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-relaxng"></a><div class="titlepage"></div><div class="refnamediv"><h2>relaxng</h2><p>relaxng &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2633488"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-nanohttp.html" title="nanohttp"><link rel="next" href="libxml-xpathInternals.html" title="xpathInternals"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-nanohttp.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xpathInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-relaxng"></a><div class="titlepage"></div><div class="refnamediv"><h2>relaxng</h2><p>relaxng &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2670900"></a>Synopsis</h1></h2><pre class="synopsis">
@ -46,6 +46,54 @@ typedef <a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGPars
struct <a href="libxml-relaxng.html#xmlRelaxNGValidCtxt">xmlRelaxNGValidCtxt</a>;
typedef <a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a>;
enum <a href="libxml-relaxng.html#xmlRelaxNGValidErr">xmlRelaxNGValidErr</a>;
<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> <a href="libxml-relaxng.html#xmlRelaxNGNewParserCtxt">xmlRelaxNGNewParserCtxt</a>
(const char *URL);
<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> <a href="libxml-relaxng.html#xmlRelaxNGNewMemParserCtxt">xmlRelaxNGNewMemParserCtxt</a>
(const char *buffer,
int size);
<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> <a href="libxml-relaxng.html#xmlRelaxNGNewDocParserCtxt">xmlRelaxNGNewDocParserCtxt</a>
(<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
void <a href="libxml-relaxng.html#xmlRelaxNGFreeParserCtxt">xmlRelaxNGFreeParserCtxt</a> (<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> ctxt);
void <a href="libxml-relaxng.html#xmlRelaxNGSetParserErrors">xmlRelaxNGSetParserErrors</a> (<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> ctxt,
<a href="libxml-relaxng.html#xmlRelaxNGValidityErrorFunc">xmlRelaxNGValidityErrorFunc</a> err,
<a href="libxml-relaxng.html#xmlRelaxNGValidityWarningFunc">xmlRelaxNGValidityWarningFunc</a> warn,
void *ctx);
int <a href="libxml-relaxng.html#xmlRelaxNGGetParserErrors">xmlRelaxNGGetParserErrors</a> (<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> ctxt,
<a href="libxml-relaxng.html#xmlRelaxNGValidityErrorFunc">xmlRelaxNGValidityErrorFunc</a> *err,
<a href="libxml-relaxng.html#xmlRelaxNGValidityWarningFunc">xmlRelaxNGValidityWarningFunc</a> *warn,
void **ctx);
<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> <a href="libxml-relaxng.html#xmlRelaxNGParse">xmlRelaxNGParse</a> (<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> ctxt);
void <a href="libxml-relaxng.html#xmlRelaxNGFree">xmlRelaxNGFree</a> (<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);
void <a href="libxml-relaxng.html#xmlRelaxNGDump">xmlRelaxNGDump</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);
void <a href="libxml-relaxng.html#xmlRelaxNGDumpTree">xmlRelaxNGDumpTree</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);
void <a href="libxml-relaxng.html#xmlRelaxNGSetValidErrors">xmlRelaxNGSetValidErrors</a> (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-relaxng.html#xmlRelaxNGValidityErrorFunc">xmlRelaxNGValidityErrorFunc</a> err,
<a href="libxml-relaxng.html#xmlRelaxNGValidityWarningFunc">xmlRelaxNGValidityWarningFunc</a> warn,
void *ctx);
int <a href="libxml-relaxng.html#xmlRelaxNGGetValidErrors">xmlRelaxNGGetValidErrors</a> (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-relaxng.html#xmlRelaxNGValidityErrorFunc">xmlRelaxNGValidityErrorFunc</a> *err,
<a href="libxml-relaxng.html#xmlRelaxNGValidityWarningFunc">xmlRelaxNGValidityWarningFunc</a> *warn,
void **ctx);
<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> <a href="libxml-relaxng.html#xmlRelaxNGNewValidCtxt">xmlRelaxNGNewValidCtxt</a>
(<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);
void <a href="libxml-relaxng.html#xmlRelaxNGFreeValidCtxt">xmlRelaxNGFreeValidCtxt</a> (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt);
int <a href="libxml-relaxng.html#xmlRelaxNGValidateDoc">xmlRelaxNGValidateDoc</a> (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
void <a href="libxml-relaxng.html#xmlRelaxNGCleanupTypes">xmlRelaxNGCleanupTypes</a> (void);
int <a href="libxml-relaxng.html#xmlRelaxNGValidatePushElement">xmlRelaxNGValidatePushElement</a> (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);
int <a href="libxml-relaxng.html#xmlRelaxNGValidatePushCData">xmlRelaxNGValidatePushCData</a> (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *data,
int len);
int <a href="libxml-relaxng.html#xmlRelaxNGValidatePopElement">xmlRelaxNGValidatePopElement</a> (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);
int <a href="libxml-relaxng.html#xmlRelaxNGValidateFullElement">xmlRelaxNGValidateFullElement</a> (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlRelaxNG"></a>struct xmlRelaxNG</h3><pre class="programlisting">struct xmlRelaxNG;</pre><p>
@ -127,4 +175,157 @@ A RelaxNGs validation context</p><p>
} xmlRelaxNGValidErr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-hash.html"><b>&lt;&lt; hash</b></a></td><td align="right"><a accesskey="n" href="libxml-xpathInternals.html"><b>xpathInternals &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGNewParserCtxt"></a>xmlRelaxNGNewParserCtxt ()</h3><pre class="programlisting"><a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> xmlRelaxNGNewParserCtxt
(const char *URL);</pre><p>
Create an XML RelaxNGs parse context for that file/resource expected
to contain an XML RelaxNGs file.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the location of the schema
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the parser context or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGNewMemParserCtxt"></a>xmlRelaxNGNewMemParserCtxt ()</h3><pre class="programlisting"><a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> xmlRelaxNGNewMemParserCtxt
(const char *buffer,
int size);</pre><p>
Create an XML RelaxNGs parse context for that memory buffer expected
to contain an XML RelaxNGs file.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array containing the schemas
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the parser context or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGNewDocParserCtxt"></a>xmlRelaxNGNewDocParserCtxt ()</h3><pre class="programlisting"><a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> xmlRelaxNGNewDocParserCtxt
(<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Create an XML RelaxNGs parser context for that document.
Note: since the process of compiling a RelaxNG schemas modifies the
document, the <i><tt>doc</tt></i> parameter is duplicated internally.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a preparsed document tree
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the parser context or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGFreeParserCtxt"></a>xmlRelaxNGFreeParserCtxt ()</h3><pre class="programlisting">void xmlRelaxNGFreeParserCtxt (<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> ctxt);</pre><p>
Free the resources associated to the schema parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the schema parser context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGSetParserErrors"></a>xmlRelaxNGSetParserErrors ()</h3><pre class="programlisting">void xmlRelaxNGSetParserErrors (<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> ctxt,
<a href="libxml-relaxng.html#xmlRelaxNGValidityErrorFunc">xmlRelaxNGValidityErrorFunc</a> err,
<a href="libxml-relaxng.html#xmlRelaxNGValidityWarningFunc">xmlRelaxNGValidityWarningFunc</a> warn,
void *ctx);</pre><p>
Set the callback functions used to handle errors for a validation context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a Relax-NG validation context
</td></tr><tr><td><span class="term"><i><tt>err</tt></i>:</span></td><td> the error callback
</td></tr><tr><td><span class="term"><i><tt>warn</tt></i>:</span></td><td> the warning callback
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> contextual data for the callbacks
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGGetParserErrors"></a>xmlRelaxNGGetParserErrors ()</h3><pre class="programlisting">int xmlRelaxNGGetParserErrors (<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> ctxt,
<a href="libxml-relaxng.html#xmlRelaxNGValidityErrorFunc">xmlRelaxNGValidityErrorFunc</a> *err,
<a href="libxml-relaxng.html#xmlRelaxNGValidityWarningFunc">xmlRelaxNGValidityWarningFunc</a> *warn,
void **ctx);</pre><p>
Get the callback information used to handle errors for a validation context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a Relax-NG validation context
</td></tr><tr><td><span class="term"><i><tt>err</tt></i>:</span></td><td> the error callback result
</td></tr><tr><td><span class="term"><i><tt>warn</tt></i>:</span></td><td> the warning callback result
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> contextual data for the callbacks result
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 in case of failure, 0 otherwise.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGParse"></a>xmlRelaxNGParse ()</h3><pre class="programlisting"><a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> xmlRelaxNGParse (<a href="libxml-relaxng.html#xmlRelaxNGParserCtxtPtr">xmlRelaxNGParserCtxtPtr</a> ctxt);</pre><p>
parse a schema definition resource and build an internal
XML Shema struture which can be used to validate instances.
*WARNING* this interface is highly subject to change</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a Relax-NG parser context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the internal XML RelaxNG structure built from the resource or
NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGFree"></a>xmlRelaxNGFree ()</h3><pre class="programlisting">void xmlRelaxNGFree (<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);</pre><p>
Deallocate a RelaxNG structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>schema</tt></i>:</span></td><td> a schema structure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGDump"></a>xmlRelaxNGDump ()</h3><pre class="programlisting">void xmlRelaxNGDump (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);</pre><p>
Dump a RelaxNG structure back</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the file output
</td></tr><tr><td><span class="term"><i><tt>schema</tt></i>:</span></td><td> a schema structure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGDumpTree"></a>xmlRelaxNGDumpTree ()</h3><pre class="programlisting">void xmlRelaxNGDumpTree (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);</pre><p>
Dump the transformed RelaxNG tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the file output
</td></tr><tr><td><span class="term"><i><tt>schema</tt></i>:</span></td><td> a schema structure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGSetValidErrors"></a>xmlRelaxNGSetValidErrors ()</h3><pre class="programlisting">void xmlRelaxNGSetValidErrors (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-relaxng.html#xmlRelaxNGValidityErrorFunc">xmlRelaxNGValidityErrorFunc</a> err,
<a href="libxml-relaxng.html#xmlRelaxNGValidityWarningFunc">xmlRelaxNGValidityWarningFunc</a> warn,
void *ctx);</pre><p>
Set the error and warning callback informations</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a Relax-NG validation context
</td></tr><tr><td><span class="term"><i><tt>err</tt></i>:</span></td><td> the error function
</td></tr><tr><td><span class="term"><i><tt>warn</tt></i>:</span></td><td> the warning function
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the functions context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGGetValidErrors"></a>xmlRelaxNGGetValidErrors ()</h3><pre class="programlisting">int xmlRelaxNGGetValidErrors (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-relaxng.html#xmlRelaxNGValidityErrorFunc">xmlRelaxNGValidityErrorFunc</a> *err,
<a href="libxml-relaxng.html#xmlRelaxNGValidityWarningFunc">xmlRelaxNGValidityWarningFunc</a> *warn,
void **ctx);</pre><p>
Get the error and warning callback informations</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a Relax-NG validation context
</td></tr><tr><td><span class="term"><i><tt>err</tt></i>:</span></td><td> the error function result
</td></tr><tr><td><span class="term"><i><tt>warn</tt></i>:</span></td><td> the warning function result
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the functions context result
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 in case of error and 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGNewValidCtxt"></a>xmlRelaxNGNewValidCtxt ()</h3><pre class="programlisting"><a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> xmlRelaxNGNewValidCtxt
(<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);</pre><p>
Create an XML RelaxNGs validation context based on the given schema</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>schema</tt></i>:</span></td><td> a precompiled XML RelaxNGs
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the validation context or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGFreeValidCtxt"></a>xmlRelaxNGFreeValidCtxt ()</h3><pre class="programlisting">void xmlRelaxNGFreeValidCtxt (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt);</pre><p>
Free the resources associated to the schema validation context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the schema validation context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGValidateDoc"></a>xmlRelaxNGValidateDoc ()</h3><pre class="programlisting">int xmlRelaxNGValidateDoc (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Validate a document tree in memory.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a Relax-NG validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a parsed document tree
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if the document is valid, a positive error code
number otherwise and -1 in case of internal or API error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGCleanupTypes"></a>xmlRelaxNGCleanupTypes ()</h3><pre class="programlisting">void xmlRelaxNGCleanupTypes (void);</pre><p>
Cleanup the default Schemas type library associated to RelaxNG</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGValidatePushElement"></a>xmlRelaxNGValidatePushElement ()</h3><pre class="programlisting">int xmlRelaxNGValidatePushElement (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);</pre><p>
Push a new element start on the RelaxNG validation stack.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if no validation problem was found or 0 if validating the
element requires a full node, and -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGValidatePushCData"></a>xmlRelaxNGValidatePushCData ()</h3><pre class="programlisting">int xmlRelaxNGValidatePushCData (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *data,
int len);</pre><p>
check the CData parsed for validation in the current stack</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the RelaxNG validation context
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> some character data read
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the lenght of the data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if no validation problem was found or -1 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGValidatePopElement"></a>xmlRelaxNGValidatePopElement ()</h3><pre class="programlisting">int xmlRelaxNGValidatePopElement (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);</pre><p>
Pop the element end from the RelaxNG validation stack.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the RelaxNG validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if no validation problem was found or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRelaxNGValidateFullElement"></a>xmlRelaxNGValidateFullElement ()</h3><pre class="programlisting">int xmlRelaxNGValidateFullElement (<a href="libxml-relaxng.html#xmlRelaxNGValidCtxtPtr">xmlRelaxNGValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);</pre><p>
Validate a full subtree when <a href="libxml-relaxng.html#xmlRelaxNGValidatePushElement">xmlRelaxNGValidatePushElement</a>() returned
0 and the content of the node has been expanded.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if no validation problem was found or -1 in case of error.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-nanohttp.html"><b>&lt;&lt; nanohttp</b></a></td><td align="right"><a accesskey="n" href="libxml-xpathInternals.html"><b>xpathInternals &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-nanoftp.html" title="nanoftp"><link rel="next" href="libxml-threads.html" title="threads"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-nanoftp.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-threads.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-schemasInternals"></a><div class="titlepage"></div><div class="refnamediv"><h2>schemasInternals</h2><p>schemasInternals &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2655300"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-nanoftp.html" title="nanoftp"><link rel="next" href="libxml-threads.html" title="threads"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-nanoftp.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-threads.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-schemasInternals"></a><div class="titlepage"></div><div class="refnamediv"><h2>schemasInternals</h2><p>schemasInternals &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2624369"></a>Synopsis</h1></h2><pre class="synopsis">
@ -68,6 +68,7 @@ typedef <a href="libxml-schemasInternals.html#xmlSchemaNotationPtr">xmlSchem
#define <a href="libxml-schemasInternals.html#XML-SCHEMAS-QUALIF-ELEM-CAPS">XML_SCHEMAS_QUALIF_ELEM</a>
#define <a href="libxml-schemasInternals.html#XML-SCHEMAS-QUALIF-ATTR-CAPS">XML_SCHEMAS_QUALIF_ATTR</a>
struct <a href="libxml-schemasInternals.html#xmlSchema">xmlSchema</a>;
void <a href="libxml-schemasInternals.html#xmlSchemaFreeType">xmlSchemaFreeType</a> (<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> type);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlSchemaTypeType"></a>enum xmlSchemaTypeType</h3><pre class="programlisting">typedef enum {
@ -288,8 +289,6 @@ the element is a reference to a type</p><p>
xmlSchemaContentType contentType;
};
</pre><p>
xmlSchemaType, xmlSchemaFacet and xmlSchemaElement start of
structures must be kept similar</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlSchemaElementPtr"></a>xmlSchemaElementPtr</h3><pre class="programlisting">typedef xmlSchemaElement *xmlSchemaElementPtr;
</pre><p>
@ -349,4 +348,8 @@ the shemas requires qualified attributes</p><p>
};
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-nanoftp.html"><b>&lt;&lt; nanoftp</b></a></td><td align="right"><a accesskey="n" href="libxml-threads.html"><b>threads &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlSchemaFreeType"></a>xmlSchemaFreeType ()</h3><pre class="programlisting">void xmlSchemaFreeType (<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> type);</pre><p>
Deallocate a Schema Type structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> a schema type structure
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-nanoftp.html"><b>&lt;&lt; nanoftp</b></a></td><td align="right"><a accesskey="n" href="libxml-threads.html"><b>threads &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="ch01.html" title="Libxml Programming Notes"><link rel="next" href="libxml-wincecompat.html" title="wincecompat"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="ch01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-wincecompat.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-testOOMlib"></a><div class="titlepage"></div><div class="refnamediv"><h2>testOOMlib</h2><p>testOOMlib &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2625421"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="ch01.html" title="Libxml Programming Notes"><link rel="next" href="libxml-wincecompat.html" title="wincecompat"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="ch01.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-wincecompat.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-testOOMlib"></a><div class="titlepage"></div><div class="refnamediv"><h2>testOOMlib</h2><p>testOOMlib &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2625490"></a>Synopsis</h1></h2><pre class="synopsis">
@ -75,16 +75,19 @@ int <a href="libxml-testOOMlib.html#test-get-malloc-blocks-outstanding">
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="test-oom-handling"></a>test_oom_handling ()</h3><pre class="programlisting">int test_oom_handling (<a href="libxml-testOOMlib.html#TestMemoryFunction">TestMemoryFunction</a> func,
void *data);</pre><p>
Tests how well the given function responds to out-of-memory
situations. Calls the function repeatedly, failing a different
call to <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() each time. If the function ever returns <GTKDOCLINK HREF="FALSE-CAPS">FALSE</GTKDOCLINK>,
the test fails. The function should return <GTKDOCLINK HREF="TRUE-CAPS">TRUE</GTKDOCLINK> whenever something
valid (such as returning an error, or succeeding) occurs, and <GTKDOCLINK HREF="FALSE-CAPS">FALSE</GTKDOCLINK>
if it gets confused in some way.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>func</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>func</tt></i>:</span></td><td> function to call
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> data to pass to function
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td><GTKDOCLINK HREF="TRUE-CAPS">TRUE</GTKDOCLINK> if the function never returns FALSE
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="test-get-malloc-blocks-outstanding"></a>test_get_malloc_blocks_outstanding ()</h3><pre class="programlisting">int test_get_malloc_blocks_outstanding
(void);</pre><p>
Get the number of outstanding <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>()'d blocks.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>number of blocks
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="ch01.html"><b>&lt;&lt; Libxml Programming Notes</b></a></td><td align="right"><a accesskey="n" href="libxml-wincecompat.html"><b>wincecompat &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-schemasInternals.html" title="schemasInternals"><link rel="next" href="libxml-parser.html" title="parser"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-schemasInternals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-parser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-threads"></a><div class="titlepage"></div><div class="refnamediv"><h2>threads</h2><p>threads &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2682889"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-schemasInternals.html" title="schemasInternals"><link rel="next" href="libxml-parser.html" title="parser"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-schemasInternals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-parser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-threads"></a><div class="titlepage"></div><div class="refnamediv"><h2>threads</h2><p>threads &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2658377"></a>Synopsis</h1></h2><pre class="synopsis">
@ -36,6 +36,21 @@ struct <a href="libxml-threads.html#xmlMutex">xmlMutex</a>;
typedef <a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a>;
struct <a href="libxml-threads.html#xmlRMutex">xmlRMutex</a>;
typedef <a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a>;
<a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a> <a href="libxml-threads.html#xmlNewMutex">xmlNewMutex</a> (void);
void <a href="libxml-threads.html#xmlMutexLock">xmlMutexLock</a> (<a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok);
void <a href="libxml-threads.html#xmlMutexUnlock">xmlMutexUnlock</a> (<a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok);
void <a href="libxml-threads.html#xmlFreeMutex">xmlFreeMutex</a> (<a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok);
<a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> <a href="libxml-threads.html#xmlNewRMutex">xmlNewRMutex</a> (void);
void <a href="libxml-threads.html#xmlRMutexLock">xmlRMutexLock</a> (<a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok);
void <a href="libxml-threads.html#xmlRMutexUnlock">xmlRMutexUnlock</a> (<a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok);
void <a href="libxml-threads.html#xmlFreeRMutex">xmlFreeRMutex</a> (<a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok);
void <a href="libxml-threads.html#xmlInitThreads">xmlInitThreads</a> (void);
void <a href="libxml-threads.html#xmlLockLibrary">xmlLockLibrary</a> (void);
void <a href="libxml-threads.html#xmlUnlockLibrary">xmlUnlockLibrary</a> (void);
int <a href="libxml-threads.html#xmlGetThreadId">xmlGetThreadId</a> (void);
int <a href="libxml-threads.html#xmlIsMainThread">xmlIsMainThread</a> (void);
void <a href="libxml-threads.html#xmlCleanupThreads">xmlCleanupThreads</a> (void);
<a href="libxml-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a> <a href="libxml-threads.html#xmlGetGlobalState">xmlGetGlobalState</a> (void);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlMutex"></a>struct xmlMutex</h3><pre class="programlisting">struct xmlMutex;</pre><p>
@ -48,4 +63,70 @@ typedef <a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a>;
</p></div><hr><div class="refsect2"><h3><a name="xmlRMutexPtr"></a>xmlRMutexPtr</h3><pre class="programlisting">typedef xmlRMutex *xmlRMutexPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-schemasInternals.html"><b>&lt;&lt; schemasInternals</b></a></td><td align="right"><a accesskey="n" href="libxml-parser.html"><b>parser &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlNewMutex"></a>xmlNewMutex ()</h3><pre class="programlisting"><a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a> xmlNewMutex (void);</pre><p>
<a href="libxml-threads.html#xmlNewMutex">xmlNewMutex</a>() is used to allocate a libxml2 token struct for use in
synchronizing access to data.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new simple mutex pointer or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMutexLock"></a>xmlMutexLock ()</h3><pre class="programlisting">void xmlMutexLock (<a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok);</pre><p>
<a href="libxml-threads.html#xmlMutexLock">xmlMutexLock</a>() is used to lock a libxml2 token.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tok</tt></i>:</span></td><td> the simple mutex
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMutexUnlock"></a>xmlMutexUnlock ()</h3><pre class="programlisting">void xmlMutexUnlock (<a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok);</pre><p>
<a href="libxml-threads.html#xmlMutexUnlock">xmlMutexUnlock</a>() is used to unlock a libxml2 token.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tok</tt></i>:</span></td><td> the simple mutex
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeMutex"></a>xmlFreeMutex ()</h3><pre class="programlisting">void xmlFreeMutex (<a href="libxml-threads.html#xmlMutexPtr">xmlMutexPtr</a> tok);</pre><p>
<a href="libxml-threads.html#xmlFreeMutex">xmlFreeMutex</a>() is used to reclaim resources associated with a libxml2 token
struct.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tok</tt></i>:</span></td><td> the simple mutex
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNewRMutex"></a>xmlNewRMutex ()</h3><pre class="programlisting"><a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> xmlNewRMutex (void);</pre><p>
<GTKDOCLINK HREF="xmlRNewMutex">xmlRNewMutex</GTKDOCLINK>() is used to allocate a reentrant mutex for use in
synchronizing access to data. token_r is a re-entrant lock and thus useful
for synchronizing access to data structures that may be manipulated in a
recursive fashion.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new reentrant mutex pointer or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRMutexLock"></a>xmlRMutexLock ()</h3><pre class="programlisting">void xmlRMutexLock (<a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok);</pre><p>
<a href="libxml-threads.html#xmlRMutexLock">xmlRMutexLock</a>() is used to lock a libxml2 token_r.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tok</tt></i>:</span></td><td> the reentrant mutex
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRMutexUnlock"></a>xmlRMutexUnlock ()</h3><pre class="programlisting">void xmlRMutexUnlock (<a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok);</pre><p>
<a href="libxml-threads.html#xmlRMutexUnlock">xmlRMutexUnlock</a>() is used to unlock a libxml2 token_r.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tok</tt></i>:</span></td><td> the reentrant mutex
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeRMutex"></a>xmlFreeRMutex ()</h3><pre class="programlisting">void xmlFreeRMutex (<a href="libxml-threads.html#xmlRMutexPtr">xmlRMutexPtr</a> tok);</pre><p>
<GTKDOCLINK HREF="xmlRFreeMutex">xmlRFreeMutex</GTKDOCLINK>() is used to reclaim resources associated with a
reentrant mutex.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tok</tt></i>:</span></td><td> the reentrant mutex
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlInitThreads"></a>xmlInitThreads ()</h3><pre class="programlisting">void xmlInitThreads (void);</pre><p>
<a href="libxml-threads.html#xmlInitThreads">xmlInitThreads</a>() is used to to initialize all the thread related
data of the libxml2 library.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlLockLibrary"></a>xmlLockLibrary ()</h3><pre class="programlisting">void xmlLockLibrary (void);</pre><p>
<a href="libxml-threads.html#xmlLockLibrary">xmlLockLibrary</a>() is used to take out a re-entrant lock on the libxml2
library.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlUnlockLibrary"></a>xmlUnlockLibrary ()</h3><pre class="programlisting">void xmlUnlockLibrary (void);</pre><p>
<a href="libxml-threads.html#xmlUnlockLibrary">xmlUnlockLibrary</a>() is used to release a re-entrant lock on the libxml2
library.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlGetThreadId"></a>xmlGetThreadId ()</h3><pre class="programlisting">int xmlGetThreadId (void);</pre><p>
<a href="libxml-threads.html#xmlGetThreadId">xmlGetThreadId</a>() find the current thread ID number</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the current thread ID number
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsMainThread"></a>xmlIsMainThread ()</h3><pre class="programlisting">int xmlIsMainThread (void);</pre><p>
<a href="libxml-threads.html#xmlIsMainThread">xmlIsMainThread</a>() check whether the current thread is the main thread.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if the current thread is the main thread, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCleanupThreads"></a>xmlCleanupThreads ()</h3><pre class="programlisting">void xmlCleanupThreads (void);</pre><p>
<a href="libxml-threads.html#xmlCleanupThreads">xmlCleanupThreads</a>() is used to to cleanup all the thread related
data of the libxml2 library once processing has ended.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlGetGlobalState"></a>xmlGetGlobalState ()</h3><pre class="programlisting"><a href="libxml-globals.html#xmlGlobalStatePtr">xmlGlobalStatePtr</a> xmlGetGlobalState (void);</pre><p>
<a href="libxml-threads.html#xmlGetGlobalState">xmlGetGlobalState</a>() is called to retrieve the global state for a thread.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the thread global state or NULL in case of error
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-schemasInternals.html"><b>&lt;&lt; schemasInternals</b></a></td><td align="right"><a accesskey="n" href="libxml-parser.html"><b>parser &gt;&gt;</b></a></td></tr></table></body></html>

File diff suppressed because it is too large Load Diff

View File

@ -28,12 +28,30 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-chvalid.html" title="chvalid"><link rel="next" href="libxml-nanoftp.html" title="nanoftp"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-chvalid.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-nanoftp.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-uri"></a><div class="titlepage"></div><div class="refnamediv"><h2>uri</h2><p>uri &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2683919"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-chvalid.html" title="chvalid"><link rel="next" href="libxml-SAX2.html" title="SAX2"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-chvalid.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-SAX2.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-uri"></a><div class="titlepage"></div><div class="refnamediv"><h2>uri</h2><p>uri &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2607872"></a>Synopsis</h1></h2><pre class="synopsis">
struct <a href="libxml-uri.html#xmlURI">xmlURI</a>;
typedef <a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a>;
<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> <a href="libxml-uri.html#xmlCreateURI">xmlCreateURI</a> (void);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-uri.html#xmlBuildURI">xmlBuildURI</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *base);
<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> <a href="libxml-uri.html#xmlParseURI">xmlParseURI</a> (const char *str);
int <a href="libxml-uri.html#xmlParseURIReference">xmlParseURIReference</a> (<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri,
const char *str);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-uri.html#xmlSaveUri">xmlSaveUri</a> (<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri);
void <a href="libxml-uri.html#xmlPrintURI">xmlPrintURI</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *stream,
<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-uri.html#xmlURIEscapeStr">xmlURIEscapeStr</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *list);
char* <a href="libxml-uri.html#xmlURIUnescapeString">xmlURIUnescapeString</a> (const char *str,
int len,
char *target);
int <a href="libxml-uri.html#xmlNormalizeURIPath">xmlNormalizeURIPath</a> (char *path);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-uri.html#xmlURIEscape">xmlURIEscape</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);
void <a href="libxml-uri.html#xmlFreeURI">xmlFreeURI</a> (<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-uri.html#xmlCanonicPath">xmlCanonicPath</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *path);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlURI"></a>struct xmlURI</h3><pre class="programlisting">struct xmlURI {
@ -56,4 +74,99 @@ as described in RFC 2396 but separated for further processing.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlURIPtr"></a>xmlURIPtr</h3><pre class="programlisting">typedef xmlURI *xmlURIPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-chvalid.html"><b>&lt;&lt; chvalid</b></a></td><td align="right"><a accesskey="n" href="libxml-nanoftp.html"><b>nanoftp &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlCreateURI"></a>xmlCreateURI ()</h3><pre class="programlisting"><a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> xmlCreateURI (void);</pre><p>
Simply creates an empty xmlURI</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new structure or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlBuildURI"></a>xmlBuildURI ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlBuildURI (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *URI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *base);</pre><p>
Computes he final URI of the reference done by checking that
the given URI is valid, and building the final URI using the
base URI. This is processed according to section 5.2 of the
RFC 2396
</p><p>
5.2. Resolving Relative References to Absolute Form</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> the URI instance found in the document
</td></tr><tr><td><span class="term"><i><tt>base</tt></i>:</span></td><td> the base value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new URI string (to be freed by the caller) or NULL in case
of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParseURI"></a>xmlParseURI ()</h3><pre class="programlisting"><a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> xmlParseURI (const char *str);</pre><p>
Parse an URI
</p><p>
URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the URI string to analyze
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a newly build xmlURIPtr or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParseURIReference"></a>xmlParseURIReference ()</h3><pre class="programlisting">int xmlParseURIReference (<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri,
const char *str);</pre><p>
Parse an URI reference string and fills in the appropriate fields
of the <i><tt>uri</tt></i> structure
</p><p>
URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>uri</tt></i>:</span></td><td> pointer to an URI structure
</td></tr><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the string to analyze
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or the error code
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSaveUri"></a>xmlSaveUri ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlSaveUri (<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri);</pre><p>
Save the URI as an escaped string</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>uri</tt></i>:</span></td><td> pointer to an xmlURI
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new string (to be deallocated by caller)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlPrintURI"></a>xmlPrintURI ()</h3><pre class="programlisting">void xmlPrintURI (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *stream,
<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri);</pre><p>
Prints the URI in the stream <i><tt>steam</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>stream</tt></i>:</span></td><td> a FILE* for the output
</td></tr><tr><td><span class="term"><i><tt>uri</tt></i>:</span></td><td> pointer to an xmlURI
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlURIEscapeStr"></a>xmlURIEscapeStr ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlURIEscapeStr (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *list);</pre><p>
This routine escapes a string to hex, ignoring reserved characters (a-z)
and the characters in the exception list.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> string to escape
</td></tr><tr><td><span class="term"><i><tt>list</tt></i>:</span></td><td> exception list string of chars not to escape
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new escaped string or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlURIUnescapeString"></a>xmlURIUnescapeString ()</h3><pre class="programlisting">char* xmlURIUnescapeString (const char *str,
int len,
char *target);</pre><p>
Unescaping routine, does not do validity checks !
Output is direct unsigned char translation of <tt>XX</tt> values (no encoding)</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the string to unescape
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the length in bytes to unescape (or &lt;= 0 to indicate full string)
</td></tr><tr><td><span class="term"><i><tt>target</tt></i>:</span></td><td> optional destination buffer
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an copy of the string, but unescaped
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNormalizeURIPath"></a>xmlNormalizeURIPath ()</h3><pre class="programlisting">int xmlNormalizeURIPath (char *path);</pre><p>
Applies the 5 normalization steps to a path string--that is, RFC 2396
Section 5.2, steps 6.c through 6.g.
</p><p>
Normalization occurs directly on the string, no new allocation is done</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>path</tt></i>:</span></td><td> pointer to the path string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or an error code
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlURIEscape"></a>xmlURIEscape ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlURIEscape (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);</pre><p>
Escaping routine, does not do validity checks !
It will try to escape the chars needing this, but this is heuristic
based it's impossible to be sure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the string of the URI to escape
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an copy of the string, but escaped
25 May 2001
Uses xmlParseURI and xmlURIEscapeStr to try to escape correctly
according to RFC2396.
- Carl Douglas
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeURI"></a>xmlFreeURI ()</h3><pre class="programlisting">void xmlFreeURI (<a href="libxml-uri.html#xmlURIPtr">xmlURIPtr</a> uri);</pre><p>
Free up the xmlURI struct</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>uri</tt></i>:</span></td><td> pointer to an xmlURI
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCanonicPath"></a>xmlCanonicPath ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlCanonicPath (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *path);</pre><p>
Constructs a canonic path from the specified path.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>path</tt></i>:</span></td><td> the resource locator in a filesystem notation
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new canonic path, or a duplicate of the path parameter if the
construction fails. The caller is responsible for freeing the memory occupied
by the returned string. If there is insufficient memory available, or the
argument is NULL, the function returns NULL.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-chvalid.html"><b>&lt;&lt; chvalid</b></a></td><td align="right"><a accesskey="n" href="libxml-SAX2.html"><b>SAX2 &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-HTMLparser.html" title="HTMLparser"><link rel="next" href="libxml-catalog.html" title="catalog"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-HTMLparser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-catalog.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-valid"></a><div class="titlepage"></div><div class="refnamediv"><h2>valid</h2><p>valid &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2639435"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-HTMLparser.html" title="HTMLparser"><link rel="next" href="libxml-catalog.html" title="catalog"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-HTMLparser.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-catalog.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-valid"></a><div class="titlepage"></div><div class="refnamediv"><h2>valid</h2><p>valid &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2818128"></a>Synopsis</h1></h2><pre class="synopsis">
@ -47,6 +47,176 @@ typedef <a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a
typedef <a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a>;
typedef <a href="libxml-valid.html#xmlIDTablePtr">xmlIDTablePtr</a>;
typedef <a href="libxml-valid.html#xmlRefTablePtr">xmlRefTablePtr</a>;
<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> <a href="libxml-valid.html#xmlNewValidCtxt">xmlNewValidCtxt</a> (void);
void <a href="libxml-valid.html#xmlFreeValidCtxt">xmlFreeValidCtxt</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a>);
<a href="libxml-tree.html#xmlNotationPtr">xmlNotationPtr</a> <a href="libxml-valid.html#xmlAddNotationDecl">xmlAddNotationDecl</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *PublicID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);
<a href="libxml-valid.html#xmlNotationTablePtr">xmlNotationTablePtr</a> <a href="libxml-valid.html#xmlCopyNotationTable">xmlCopyNotationTable</a> (<a href="libxml-valid.html#xmlNotationTablePtr">xmlNotationTablePtr</a> table);
void <a href="libxml-valid.html#xmlFreeNotationTable">xmlFreeNotationTable</a> (<a href="libxml-valid.html#xmlNotationTablePtr">xmlNotationTablePtr</a> table);
void <a href="libxml-valid.html#xmlDumpNotationDecl">xmlDumpNotationDecl</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlNotationPtr">xmlNotationPtr</a> nota);
void <a href="libxml-valid.html#xmlDumpNotationTable">xmlDumpNotationTable</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-valid.html#xmlNotationTablePtr">xmlNotationTablePtr</a> table);
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> <a href="libxml-valid.html#xmlNewElementContent">xmlNewElementContent</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
<a href="libxml-tree.html#xmlElementContentType">xmlElementContentType</a> type);
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> <a href="libxml-valid.html#xmlCopyElementContent">xmlCopyElementContent</a> (<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content);
void <a href="libxml-valid.html#xmlFreeElementContent">xmlFreeElementContent</a> (<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> cur);
void <a href="libxml-valid.html#xmlSnprintfElementContent">xmlSnprintfElementContent</a> (char *buf,
int size,
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content,
int glob);
void <a href="libxml-valid.html#xmlSprintfElementContent">xmlSprintfElementContent</a> (char *buf,
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content,
int glob);
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> <a href="libxml-valid.html#xmlAddElementDecl">xmlAddElementDecl</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
<a href="libxml-tree.html#xmlElementTypeVal">xmlElementTypeVal</a> type,
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content);
<a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a> <a href="libxml-valid.html#xmlCopyElementTable">xmlCopyElementTable</a> (<a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a> table);
void <a href="libxml-valid.html#xmlFreeElementTable">xmlFreeElementTable</a> (<a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a> table);
void <a href="libxml-valid.html#xmlDumpElementTable">xmlDumpElementTable</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a> table);
void <a href="libxml-valid.html#xmlDumpElementDecl">xmlDumpElementDecl</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> elem);
<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> <a href="libxml-valid.html#xmlCreateEnumeration">xmlCreateEnumeration</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
void <a href="libxml-valid.html#xmlFreeEnumeration">xmlFreeEnumeration</a> (<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> cur);
<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> <a href="libxml-valid.html#xmlCopyEnumeration">xmlCopyEnumeration</a> (<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> cur);
<a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> <a href="libxml-valid.html#xmlAddAttributeDecl">xmlAddAttributeDecl</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ns,
<a href="libxml-tree.html#xmlAttributeType">xmlAttributeType</a> type,
<a href="libxml-tree.html#xmlAttributeDefault">xmlAttributeDefault</a> def,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *defaultValue,
<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> tree);
<a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a> <a href="libxml-valid.html#xmlCopyAttributeTable">xmlCopyAttributeTable</a> (<a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a> table);
void <a href="libxml-valid.html#xmlFreeAttributeTable">xmlFreeAttributeTable</a> (<a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a> table);
void <a href="libxml-valid.html#xmlDumpAttributeTable">xmlDumpAttributeTable</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a> table);
void <a href="libxml-valid.html#xmlDumpAttributeDecl">xmlDumpAttributeDecl</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> attr);
<a href="libxml-tree.html#xmlIDPtr">xmlIDPtr</a> <a href="libxml-valid.html#xmlAddID">xmlAddID</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);
void <a href="libxml-valid.html#xmlFreeIDTable">xmlFreeIDTable</a> (<a href="libxml-valid.html#xmlIDTablePtr">xmlIDTablePtr</a> table);
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> <a href="libxml-valid.html#xmlGetID">xmlGetID</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ID);
int <a href="libxml-valid.html#xmlIsID">xmlIsID</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);
int <a href="libxml-valid.html#xmlRemoveID">xmlRemoveID</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);
<a href="libxml-tree.html#xmlRefPtr">xmlRefPtr</a> <a href="libxml-valid.html#xmlAddRef">xmlAddRef</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);
void <a href="libxml-valid.html#xmlFreeRefTable">xmlFreeRefTable</a> (<a href="libxml-valid.html#xmlRefTablePtr">xmlRefTablePtr</a> table);
int <a href="libxml-valid.html#xmlIsRef">xmlIsRef</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);
int <a href="libxml-valid.html#xmlRemoveRef">xmlRemoveRef</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);
<a href="libxml-list.html#xmlListPtr">xmlListPtr</a> <a href="libxml-valid.html#xmlGetRefs">xmlGetRefs</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ID);
int <a href="libxml-valid.html#xmlValidateRoot">xmlValidateRoot</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
int <a href="libxml-valid.html#xmlValidateElementDecl">xmlValidateElementDecl</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> elem);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-valid.html#xmlValidNormalizeAttributeValue">xmlValidNormalizeAttributeValue</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-valid.html#xmlValidCtxtNormalizeAttributeValue">xmlValidCtxtNormalizeAttributeValue</a>
(<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
int <a href="libxml-valid.html#xmlValidateAttributeDecl">xmlValidateAttributeDecl</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> attr);
int <a href="libxml-valid.html#xmlValidateAttributeValue">xmlValidateAttributeValue</a> (<a href="libxml-tree.html#xmlAttributeType">xmlAttributeType</a> type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
int <a href="libxml-valid.html#xmlValidateNotationDecl">xmlValidateNotationDecl</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNotationPtr">xmlNotationPtr</a> nota);
int <a href="libxml-valid.html#xmlValidateDtd">xmlValidateDtd</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd);
int <a href="libxml-valid.html#xmlValidateDtdFinal">xmlValidateDtdFinal</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
int <a href="libxml-valid.html#xmlValidateDocument">xmlValidateDocument</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
int <a href="libxml-valid.html#xmlValidateElement">xmlValidateElement</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);
int <a href="libxml-valid.html#xmlValidateOneElement">xmlValidateOneElement</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);
int <a href="libxml-valid.html#xmlValidateOneAttribute">xmlValidateOneAttribute</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
int <a href="libxml-valid.html#xmlValidateOneNamespace">xmlValidateOneNamespace</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
<a href="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> ns,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
int <a href="libxml-valid.html#xmlValidateDocumentFinal">xmlValidateDocumentFinal</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
int <a href="libxml-valid.html#xmlValidateNotationUse">xmlValidateNotationUse</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *notationName);
int <a href="libxml-valid.html#xmlIsMixedElement">xmlIsMixedElement</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
<a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> <a href="libxml-valid.html#xmlGetDtdAttrDesc">xmlGetDtdAttrDesc</a> (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
<a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> <a href="libxml-valid.html#xmlGetDtdQAttrDesc">xmlGetDtdQAttrDesc</a> (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);
<a href="libxml-tree.html#xmlNotationPtr">xmlNotationPtr</a> <a href="libxml-valid.html#xmlGetDtdNotationDesc">xmlGetDtdNotationDesc</a> (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> <a href="libxml-valid.html#xmlGetDtdQElementDesc">xmlGetDtdQElementDesc</a> (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> <a href="libxml-valid.html#xmlGetDtdElementDesc">xmlGetDtdElementDesc</a> (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
int <a href="libxml-valid.html#xmlValidGetValidElements">xmlValidGetValidElements</a> (<a href="libxml-tree.html#xmlNode">xmlNode</a> *prev,
<a href="libxml-tree.html#xmlNode">xmlNode</a> *next,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> **list,
int max);
int <a href="libxml-valid.html#xmlValidGetPotentialChildren">xmlValidGetPotentialChildren</a> (<a href="libxml-tree.html#xmlElementContent">xmlElementContent</a> *ctree,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> **list,
int *len,
int max);
int <a href="libxml-valid.html#xmlValidateNameValue">xmlValidateNameValue</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
int <a href="libxml-valid.html#xmlValidateNamesValue">xmlValidateNamesValue</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
int <a href="libxml-valid.html#xmlValidateNmtokenValue">xmlValidateNmtokenValue</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
int <a href="libxml-valid.html#xmlValidateNmtokensValue">xmlValidateNmtokensValue</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
int <a href="libxml-valid.html#xmlValidBuildContentModel">xmlValidBuildContentModel</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> elem);
int <a href="libxml-valid.html#xmlValidatePushElement">xmlValidatePushElement</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *qname);
int <a href="libxml-valid.html#xmlValidatePushCData">xmlValidatePushCData</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *data,
int len);
int <a href="libxml-valid.html#xmlValidatePopElement">xmlValidatePopElement</a> (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *qname);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlValidState"></a>struct xmlValidState</h3><pre class="programlisting">struct xmlValidState;</pre><p>
@ -103,7 +273,6 @@ oriented function similar to an *printf function.</p><p>
#endif
};
</pre><p>
</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlValidCtxtPtr"></a>xmlValidCtxtPtr</h3><pre class="programlisting">typedef xmlValidCtxt *xmlValidCtxtPtr;
</pre><p>
@ -123,4 +292,663 @@ oriented function similar to an *printf function.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlRefTablePtr"></a>xmlRefTablePtr</h3><pre class="programlisting">typedef xmlRefTable *xmlRefTablePtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-HTMLparser.html"><b>&lt;&lt; HTMLparser</b></a></td><td align="right"><a accesskey="n" href="libxml-catalog.html"><b>catalog &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlNewValidCtxt"></a>xmlNewValidCtxt ()</h3><pre class="programlisting"><a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> xmlNewValidCtxt (void);</pre><p>
Allocate a validation context structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not, otherwise the new validation context structure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeValidCtxt"></a>xmlFreeValidCtxt ()</h3><pre class="programlisting">void xmlFreeValidCtxt (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a>);</pre><p>
Free a validation context structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>Param1</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAddNotationDecl"></a>xmlAddNotationDecl ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlNotationPtr">xmlNotationPtr</a> xmlAddNotationDecl (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *PublicID,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID);</pre><p>
Register a new notation declaration</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> pointer to the DTD
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><i><tt>PublicID</tt></i>:</span></td><td> the public identifier or NULL
</td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i>:</span></td><td> the system identifier or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not, otherwise the entity
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCopyNotationTable"></a>xmlCopyNotationTable ()</h3><pre class="programlisting"><a href="libxml-valid.html#xmlNotationTablePtr">xmlNotationTablePtr</a> xmlCopyNotationTable (<a href="libxml-valid.html#xmlNotationTablePtr">xmlNotationTablePtr</a> table);</pre><p>
Build a copy of a notation table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> A notation table
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlNotationTablePtr or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeNotationTable"></a>xmlFreeNotationTable ()</h3><pre class="programlisting">void xmlFreeNotationTable (<a href="libxml-valid.html#xmlNotationTablePtr">xmlNotationTablePtr</a> table);</pre><p>
Deallocate the memory used by an entities hash table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An notation table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDumpNotationDecl"></a>xmlDumpNotationDecl ()</h3><pre class="programlisting">void xmlDumpNotationDecl (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlNotationPtr">xmlNotationPtr</a> nota);</pre><p>
This will dump the content the notation declaration as an XML DTD definition</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the XML buffer output
</td></tr><tr><td><span class="term"><i><tt>nota</tt></i>:</span></td><td> A notation declaration
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDumpNotationTable"></a>xmlDumpNotationTable ()</h3><pre class="programlisting">void xmlDumpNotationTable (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-valid.html#xmlNotationTablePtr">xmlNotationTablePtr</a> table);</pre><p>
This will dump the content of the notation table as an XML DTD definition</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the XML buffer output
</td></tr><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> A notation table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNewElementContent"></a>xmlNewElementContent ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> xmlNewElementContent (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
<a href="libxml-tree.html#xmlElementContentType">xmlElementContentType</a> type);</pre><p>
Allocate an element content structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the subelement name or NULL
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the type of element content decl
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not, otherwise the new element content structure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCopyElementContent"></a>xmlCopyElementContent ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> xmlCopyElementContent (<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content);</pre><p>
Build a copy of an element content description.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlElementContentPtr or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeElementContent"></a>xmlFreeElementContent ()</h3><pre class="programlisting">void xmlFreeElementContent (<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> cur);</pre><p>
Free an element content structure. This is a recursive call !</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the element content tree to free
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSnprintfElementContent"></a>xmlSnprintfElementContent ()</h3><pre class="programlisting">void xmlSnprintfElementContent (char *buf,
int size,
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content,
int glob);</pre><p>
This will dump the content of the element content definition
Intended just for the debug routine</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> an output buffer
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the buffer size
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> An element table
</td></tr><tr><td><span class="term"><i><tt>glob</tt></i>:</span></td><td> 1 if one must print the englobing parenthesis, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSprintfElementContent"></a>xmlSprintfElementContent ()</h3><pre class="programlisting">void xmlSprintfElementContent (char *buf,
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content,
int glob);</pre><p>
Deprecated, unsafe, use xmlSnprintfElementContent</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> an output buffer
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> An element table
</td></tr><tr><td><span class="term"><i><tt>glob</tt></i>:</span></td><td> 1 if one must print the englobing parenthesis, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAddElementDecl"></a>xmlAddElementDecl ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> xmlAddElementDecl (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
<a href="libxml-tree.html#xmlElementTypeVal">xmlElementTypeVal</a> type,
<a href="libxml-tree.html#xmlElementContentPtr">xmlElementContentPtr</a> content);</pre><p>
Register a new element declaration</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> pointer to the DTD
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the entity name
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the element type
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> the element content tree or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not, otherwise the entity
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCopyElementTable"></a>xmlCopyElementTable ()</h3><pre class="programlisting"><a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a> xmlCopyElementTable (<a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a> table);</pre><p>
Build a copy of an element table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An element table
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlElementTablePtr or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeElementTable"></a>xmlFreeElementTable ()</h3><pre class="programlisting">void xmlFreeElementTable (<a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a> table);</pre><p>
Deallocate the memory used by an element hash table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An element table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDumpElementTable"></a>xmlDumpElementTable ()</h3><pre class="programlisting">void xmlDumpElementTable (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-valid.html#xmlElementTablePtr">xmlElementTablePtr</a> table);</pre><p>
This will dump the content of the element table as an XML DTD definition</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the XML buffer output
</td></tr><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An element table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDumpElementDecl"></a>xmlDumpElementDecl ()</h3><pre class="programlisting">void xmlDumpElementDecl (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> elem);</pre><p>
This will dump the content of the element declaration as an XML
DTD definition</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the XML buffer output
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> An element table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCreateEnumeration"></a>xmlCreateEnumeration ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> xmlCreateEnumeration (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
create and initialize an enumeration attribute node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the enumeration name or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlEnumerationPtr just created or NULL in case
of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeEnumeration"></a>xmlFreeEnumeration ()</h3><pre class="programlisting">void xmlFreeEnumeration (<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> cur);</pre><p>
free an enumeration attribute node (recursive).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the tree to free.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCopyEnumeration"></a>xmlCopyEnumeration ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> xmlCopyEnumeration (<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> cur);</pre><p>
Copy an enumeration attribute node (recursive).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the tree to copy.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlEnumerationPtr just created or NULL in case
of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAddAttributeDecl"></a>xmlAddAttributeDecl ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> xmlAddAttributeDecl (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ns,
<a href="libxml-tree.html#xmlAttributeType">xmlAttributeType</a> type,
<a href="libxml-tree.html#xmlAttributeDefault">xmlAttributeDefault</a> def,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *defaultValue,
<a href="libxml-tree.html#xmlEnumerationPtr">xmlEnumerationPtr</a> tree);</pre><p>
Register a new attribute declaration
Note that <i><tt>tree</tt></i> becomes the ownership of the DTD</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> pointer to the DTD
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the element name
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the attribute name
</td></tr><tr><td><span class="term"><i><tt>ns</tt></i>:</span></td><td> the attribute namespace prefix
</td></tr><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the attribute type
</td></tr><tr><td><span class="term"><i><tt>def</tt></i>:</span></td><td> the attribute default type
</td></tr><tr><td><span class="term"><i><tt>defaultValue</tt></i>:</span></td><td> the attribute default value
</td></tr><tr><td><span class="term"><i><tt>tree</tt></i>:</span></td><td> if it's an enumeration, the associated list
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not new, otherwise the attribute decl
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCopyAttributeTable"></a>xmlCopyAttributeTable ()</h3><pre class="programlisting"><a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a> xmlCopyAttributeTable (<a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a> table);</pre><p>
Build a copy of an attribute table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An attribute table
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlAttributeTablePtr or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeAttributeTable"></a>xmlFreeAttributeTable ()</h3><pre class="programlisting">void xmlFreeAttributeTable (<a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a> table);</pre><p>
Deallocate the memory used by an entities hash table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An attribute table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDumpAttributeTable"></a>xmlDumpAttributeTable ()</h3><pre class="programlisting">void xmlDumpAttributeTable (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-valid.html#xmlAttributeTablePtr">xmlAttributeTablePtr</a> table);</pre><p>
This will dump the content of the attribute table as an XML DTD definition</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the XML buffer output
</td></tr><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An attribute table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlDumpAttributeDecl"></a>xmlDumpAttributeDecl ()</h3><pre class="programlisting">void xmlDumpAttributeDecl (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
<a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> attr);</pre><p>
This will dump the content of the attribute declaration as an XML
DTD definition</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> the XML buffer output
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> An attribute declaration
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAddID"></a>xmlAddID ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlIDPtr">xmlIDPtr</a> xmlAddID (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);</pre><p>
Register a new id declaration</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> pointer to the document
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the value name
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> the attribute holding the ID
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not, otherwise the new xmlIDPtr
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeIDTable"></a>xmlFreeIDTable ()</h3><pre class="programlisting">void xmlFreeIDTable (<a href="libxml-valid.html#xmlIDTablePtr">xmlIDTablePtr</a> table);</pre><p>
Deallocate the memory used by an ID hash table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An id table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetID"></a>xmlGetID ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlGetID (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ID);</pre><p>
Search the attribute declaring the given ID</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> pointer to the document
</td></tr><tr><td><span class="term"><i><tt>ID</tt></i>:</span></td><td> the ID value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not found, otherwise the xmlAttrPtr defining the ID
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsID"></a>xmlIsID ()</h3><pre class="programlisting">int xmlIsID (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);</pre><p>
Determine whether an attribute is of type ID. In case we have DTD(s)
then this is done if DTD loading has been requested. In the case
of HTML documents parsed with the HTML parser, then ID detection is
done systematically.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the element carrying the attribute
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> the attribute
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or 1 depending on the lookup result
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRemoveID"></a>xmlRemoveID ()</h3><pre class="programlisting">int xmlRemoveID (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);</pre><p>
Remove the given attribute from the ID table maintained internally.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> the attribute
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 if the lookup failed and 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAddRef"></a>xmlAddRef ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlRefPtr">xmlRefPtr</a> xmlAddRef (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);</pre><p>
Register a new ref declaration</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> pointer to the document
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the value name
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> the attribute holding the Ref
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not, otherwise the new xmlRefPtr
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeRefTable"></a>xmlFreeRefTable ()</h3><pre class="programlisting">void xmlFreeRefTable (<a href="libxml-valid.html#xmlRefTablePtr">xmlRefTablePtr</a> table);</pre><p>
Deallocate the memory used by an Ref hash table.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>table</tt></i>:</span></td><td> An ref table
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsRef"></a>xmlIsRef ()</h3><pre class="programlisting">int xmlIsRef (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);</pre><p>
Determine whether an attribute is of type Ref. In case we have DTD(s)
then this is simple, otherwise we use an heuristic: name Ref (upper
or lowercase).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the element carrying the attribute
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> the attribute
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or 1 depending on the lookup result
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRemoveRef"></a>xmlRemoveRef ()</h3><pre class="programlisting">int xmlRemoveRef (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr);</pre><p>
Remove the given attribute from the Ref table maintained internally.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> the attribute
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 if the lookup failed and 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetRefs"></a>xmlGetRefs ()</h3><pre class="programlisting"><a href="libxml-list.html#xmlListPtr">xmlListPtr</a> xmlGetRefs (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ID);</pre><p>
Find the set of references for the supplied ID.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> pointer to the document
</td></tr><tr><td><span class="term"><i><tt>ID</tt></i>:</span></td><td> the ID value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if not found, otherwise node set for the ID.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateRoot"></a>xmlValidateRoot ()</h3><pre class="programlisting">int xmlValidateRoot (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Try to validate a the root element
basically it does the following check as described by the
XML-1.0 recommendation:
- [ VC: Root Element Type ]
it doesn't try to recurse or apply other check to the element</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateElementDecl"></a>xmlValidateElementDecl ()</h3><pre class="programlisting">int xmlValidateElementDecl (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> elem);</pre><p>
Try to validate a single element definition
basically it does the following checks as described by the
XML-1.0 recommendation:
- [ VC: One ID per Element Type ]
- [ VC: No Duplicate Types ]
- [ VC: Unique Element Type Declaration ]</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element definition
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidNormalizeAttributeValue"></a>xmlValidNormalizeAttributeValue ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlValidNormalizeAttributeValue (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Does the validation related extra step of the normalization of attribute
values:
</p><p>
If the declared value is not CDATA, then the XML processor must further
process the normalized attribute value by discarding any leading and
trailing space (<GTKDOCLINK HREF="x20">x20</GTKDOCLINK>) characters, and by replacing sequences of space
(<GTKDOCLINK HREF="x20">x20</GTKDOCLINK>) characters by single space (<GTKDOCLINK HREF="x20">x20</GTKDOCLINK>) character.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the parent
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the attribute name
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the attribute value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new normalized string if normalization is needed, NULL otherwise
the caller must free the returned value.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidCtxtNormalizeAttributeValue"></a>xmlValidCtxtNormalizeAttributeValue ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlValidCtxtNormalizeAttributeValue
(<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Does the validation related extra step of the normalization of attribute
values:
</p><p>
If the declared value is not CDATA, then the XML processor must further
process the normalized attribute value by discarding any leading and
trailing space (<GTKDOCLINK HREF="x20">x20</GTKDOCLINK>) characters, and by replacing sequences of space
(<GTKDOCLINK HREF="x20">x20</GTKDOCLINK>) characters by single space (<GTKDOCLINK HREF="x20">x20</GTKDOCLINK>) character.
</p><p>
Also check VC: Standalone Document Declaration in P32, and update
ctxt-&gt;valid accordingly</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the parent
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the attribute name
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the attribute value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new normalized string if normalization is needed, NULL otherwise
the caller must free the returned value.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateAttributeDecl"></a>xmlValidateAttributeDecl ()</h3><pre class="programlisting">int xmlValidateAttributeDecl (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> attr);</pre><p>
Try to validate a single attribute definition
basically it does the following checks as described by the
XML-1.0 recommendation:
- [ VC: Attribute Default Legal ]
- [ VC: Enumeration ]
- [ VC: ID Attribute Default ]
</p><p>
The ID/IDREF uniqueness and matching are done separately</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> an attribute definition
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateAttributeValue"></a>xmlValidateAttributeValue ()</h3><pre class="programlisting">int xmlValidateAttributeValue (<a href="libxml-tree.html#xmlAttributeType">xmlAttributeType</a> type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Validate that the given attribute value match the proper production
</p><p>
[ VC: ID ]
Values of type ID must match the Name production....
</p><p>
[ VC: IDREF ]
Values of type IDREF must match the Name production, and values
of type IDREFS must match Names ...
</p><p>
[ VC: Entity Name ]
Values of type ENTITY must match the Name production, values
of type ENTITIES must match Names ...
</p><p>
[ VC: Name Token ]
Values of type NMTOKEN must match the Nmtoken production; values
of type NMTOKENS must match Nmtokens.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> an attribute type
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> an attribute value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateNotationDecl"></a>xmlValidateNotationDecl ()</h3><pre class="programlisting">int xmlValidateNotationDecl (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNotationPtr">xmlNotationPtr</a> nota);</pre><p>
Try to validate a single notation definition
basically it does the following checks as described by the
XML-1.0 recommendation:
- it seems that no validity constraint exists on notation declarations
But this function get called anyway ...</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>nota</tt></i>:</span></td><td> a notation definition
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateDtd"></a>xmlValidateDtd ()</h3><pre class="programlisting">int xmlValidateDtd (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd);</pre><p>
Try to validate the document against the dtd instance
</p><p>
basically it does check all the definitions in the DtD.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> a dtd instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateDtdFinal"></a>xmlValidateDtdFinal ()</h3><pre class="programlisting">int xmlValidateDtdFinal (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Does the final step for the dtds validation once all the
subsets have been parsed
</p><p>
basically it does the following checks described by the XML Rec
- check that ENTITY and ENTITIES type attributes default or
possible values matches one of the defined entities.
- check that NOTATION type attributes default or
possible values matches one of the defined notations.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 if invalid and -1 if not well-formed
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateDocument"></a>xmlValidateDocument ()</h3><pre class="programlisting">int xmlValidateDocument (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Try to validate the document instance
</p><p>
basically it does the all the checks described by the XML Rec
i.e. validates the internal and external subset (if present)
and validate the document tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateElement"></a>xmlValidateElement ()</h3><pre class="programlisting">int xmlValidateElement (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);</pre><p>
Try to validate the subtree under an element</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateOneElement"></a>xmlValidateOneElement ()</h3><pre class="programlisting">int xmlValidateOneElement (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem);</pre><p>
Try to validate a single element and it's attributes,
basically it does the following checks as described by the
XML-1.0 recommendation:
- [ VC: Element Valid ]
- [ VC: Required Attribute ]
Then call <a href="libxml-valid.html#xmlValidateOneAttribute">xmlValidateOneAttribute</a>() for each attribute present.
</p><p>
The ID/IDREF checkings are done separately</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateOneAttribute"></a>xmlValidateOneAttribute ()</h3><pre class="programlisting">int xmlValidateOneAttribute (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
<a href="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Try to validate a single attribute for an element
basically it does the following checks as described by the
XML-1.0 recommendation:
- [ VC: Attribute Value Type ]
- [ VC: Fixed Attribute Default ]
- [ VC: Entity Name ]
- [ VC: Name Token ]
- [ VC: ID ]
- [ VC: IDREF ]
- [ VC: Entity Name ]
- [ VC: Notation Attributes ]
</p><p>
The ID/IDREF uniqueness and matching are done separately</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><i><tt>attr</tt></i>:</span></td><td> an attribute instance
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the attribute value (without entities processing)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateOneNamespace"></a>xmlValidateOneNamespace ()</h3><pre class="programlisting">int xmlValidateOneNamespace (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
<a href="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> ns,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Try to validate a single namespace declaration for an element
basically it does the following checks as described by the
XML-1.0 recommendation:
- [ VC: Attribute Value Type ]
- [ VC: Fixed Attribute Default ]
- [ VC: Entity Name ]
- [ VC: Name Token ]
- [ VC: ID ]
- [ VC: IDREF ]
- [ VC: Entity Name ]
- [ VC: Notation Attributes ]
</p><p>
The ID/IDREF uniqueness and matching are done separately</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the namespace prefix
</td></tr><tr><td><span class="term"><i><tt>ns</tt></i>:</span></td><td> an namespace declaration instance
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the attribute value (without entities processing)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateDocumentFinal"></a>xmlValidateDocumentFinal ()</h3><pre class="programlisting">int xmlValidateDocumentFinal (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Does the final step for the document validation once all the
incremental validation steps have been completed
</p><p>
basically it does the following checks described by the XML Rec
</p><p>
Check all the IDREF/IDREFS attributes definition for validity</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateNotationUse"></a>xmlValidateNotationUse ()</h3><pre class="programlisting">int xmlValidateNotationUse (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *notationName);</pre><p>
Validate that the given name match a notation declaration.
- [ VC: Notation Declared ]</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>notationName</tt></i>:</span></td><td> the notation name to check
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIsMixedElement"></a>xmlIsMixedElement ()</h3><pre class="programlisting">int xmlIsMixedElement (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Search in the DtDs whether an element accept Mixed content (or ANY)
basically if it is supposed to accept text childs</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the document
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the element name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if no, 1 if yes, and -1 if no element description is available
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetDtdAttrDesc"></a>xmlGetDtdAttrDesc ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> xmlGetDtdAttrDesc (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Search the DTD for the description of this attribute on
this element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> a pointer to the DtD to search
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the element name
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the attribute name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlAttributePtr if found or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetDtdQAttrDesc"></a>xmlGetDtdQAttrDesc ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlAttributePtr">xmlAttributePtr</a> xmlGetDtdQAttrDesc (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);</pre><p>
Search the DTD for the description of this qualified attribute on
this element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> a pointer to the DtD to search
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> the element name
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the attribute name
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the attribute namespace prefix
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlAttributePtr if found or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetDtdNotationDesc"></a>xmlGetDtdNotationDesc ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlNotationPtr">xmlNotationPtr</a> xmlGetDtdNotationDesc (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Search the DTD for the description of this notation</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> a pointer to the DtD to search
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the notation name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlNotationPtr if found or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetDtdQElementDesc"></a>xmlGetDtdQElementDesc ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> xmlGetDtdQElementDesc (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);</pre><p>
Search the DTD for the description of this element</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> a pointer to the DtD to search
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the element name
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the element namespace prefix
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlElementPtr if found or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetDtdElementDesc"></a>xmlGetDtdElementDesc ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> xmlGetDtdElementDesc (<a href="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Search the DTD for the description of this element</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>dtd</tt></i>:</span></td><td> a pointer to the DtD to search
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the element name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlElementPtr if found or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidGetValidElements"></a>xmlValidGetValidElements ()</h3><pre class="programlisting">int xmlValidGetValidElements (<a href="libxml-tree.html#xmlNode">xmlNode</a> *prev,
<a href="libxml-tree.html#xmlNode">xmlNode</a> *next,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> **list,
int max);</pre><p>
This function returns the list of authorized children to insert
within an existing tree while respecting the validity constraints
forced by the Dtd. The insertion point is defined using <i><tt>prev</tt></i> and
<i><tt>next</tt></i> in the following ways:
to insert before 'node': xmlValidGetValidElements(node-&gt;prev, node, ...
to insert next 'node': xmlValidGetValidElements(node, node-&gt;next, ...
to replace 'node': xmlValidGetValidElements(node-&gt;prev, node-&gt;next, ...
to prepend a child to 'node': xmlValidGetValidElements(NULL, node-&gt;childs,
to append a child to 'node': xmlValidGetValidElements(node-&gt;last, NULL, ...
</p><p>
pointers to the element names are inserted at the beginning of the array
and do not need to be freed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>prev</tt></i>:</span></td><td> an element to insert after
</td></tr><tr><td><span class="term"><i><tt>next</tt></i>:</span></td><td> an element to insert next
</td></tr><tr><td><span class="term"><i><tt>list</tt></i>:</span></td><td> an array to store the list of child names
</td></tr><tr><td><span class="term"><i><tt>max</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of element in the list, or -1 in case of error. If
the function returns the value <i><tt>max</tt></i> the caller is invited to grow the
receiving array and retry.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidGetPotentialChildren"></a>xmlValidGetPotentialChildren ()</h3><pre class="programlisting">int xmlValidGetPotentialChildren (<a href="libxml-tree.html#xmlElementContent">xmlElementContent</a> *ctree,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> **list,
int *len,
int max);</pre><p>
Build/extend a list of potential children allowed by the content tree</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctree</tt></i>:</span></td><td> an element content tree
</td></tr><tr><td><span class="term"><i><tt>list</tt></i>:</span></td><td> an array to store the list of child names
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> a pointer to the number of element in the list
</td></tr><tr><td><span class="term"><i><tt>max</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of element in the list, or -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateNameValue"></a>xmlValidateNameValue ()</h3><pre class="programlisting">int xmlValidateNameValue (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Validate that the given value match Name production</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> an Name value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateNamesValue"></a>xmlValidateNamesValue ()</h3><pre class="programlisting">int xmlValidateNamesValue (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Validate that the given value match Names production</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> an Names value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateNmtokenValue"></a>xmlValidateNmtokenValue ()</h3><pre class="programlisting">int xmlValidateNmtokenValue (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Validate that the given value match Nmtoken production
</p><p>
[ VC: Name Token ]</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> an Nmtoken value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidateNmtokensValue"></a>xmlValidateNmtokensValue ()</h3><pre class="programlisting">int xmlValidateNmtokensValue (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Validate that the given value match Nmtokens production
</p><p>
[ VC: Name Token ]</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> an Nmtokens value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if valid or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidBuildContentModel"></a>xmlValidBuildContentModel ()</h3><pre class="programlisting">int xmlValidBuildContentModel (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlElementPtr">xmlElementPtr</a> elem);</pre><p>
(Re)Build the automata associated to the content model of this
element</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a validation context
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element declaration node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 in case of success, 0 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidatePushElement"></a>xmlValidatePushElement ()</h3><pre class="programlisting">int xmlValidatePushElement (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *qname);</pre><p>
Push a new element start on the validation stack.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><i><tt>qname</tt></i>:</span></td><td> the qualified name as appearing in the serialization
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if no validation problem was found or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidatePushCData"></a>xmlValidatePushCData ()</h3><pre class="programlisting">int xmlValidatePushCData (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *data,
int len);</pre><p>
check the CData parsed for validation in the current stack</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> some character data read
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the lenght of the data
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if no validation problem was found or 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlValidatePopElement"></a>xmlValidatePopElement ()</h3><pre class="programlisting">int xmlValidatePopElement (<a href="libxml-valid.html#xmlValidCtxtPtr">xmlValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *qname);</pre><p>
Pop the element end from the validation stack.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the validation context
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a document instance
</td></tr><tr><td><span class="term"><i><tt>elem</tt></i>:</span></td><td> an element instance
</td></tr><tr><td><span class="term"><i><tt>qname</tt></i>:</span></td><td> the qualified name as appearing in the serialization
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if no validation problem was found or 0 otherwise
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-HTMLparser.html"><b>&lt;&lt; HTMLparser</b></a></td><td align="right"><a accesskey="n" href="libxml-catalog.html"><b>catalog &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-testOOMlib.html" title="testOOMlib"><link rel="next" href="libxml-wsockcompat.html" title="wsockcompat"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-testOOMlib.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-wsockcompat.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-wincecompat"></a><div class="titlepage"></div><div class="refnamediv"><h2>wincecompat</h2><p>wincecompat &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2649847"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-testOOMlib.html" title="testOOMlib"><link rel="next" href="libxml-wsockcompat.html" title="wsockcompat"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-testOOMlib.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-wsockcompat.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-wincecompat"></a><div class="titlepage"></div><div class="refnamediv"><h2>wincecompat</h2><p>wincecompat &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2654638"></a>Synopsis</h1></h2><pre class="synopsis">

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-wincecompat.html" title="wincecompat"><link rel="next" href="libxml-encoding.html" title="encoding"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-wincecompat.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-encoding.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-wsockcompat"></a><div class="titlepage"></div><div class="refnamediv"><h2>wsockcompat</h2><p>wsockcompat &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2641333"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-wincecompat.html" title="wincecompat"><link rel="next" href="libxml-encoding.html" title="encoding"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-wincecompat.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-encoding.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-wsockcompat"></a><div class="titlepage"></div><div class="refnamediv"><h2>wsockcompat</h2><p>wsockcompat &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2607006"></a>Synopsis</h1></h2><pre class="synopsis">

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlexports.html" title="xmlexports"><link rel="next" href="libxml-xmlreader.html" title="xmlreader"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlexports.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlreader.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xinclude"></a><div class="titlepage"></div><div class="refnamediv"><h2>xinclude</h2><p>xinclude &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2689077"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlexports.html" title="xmlexports"><link rel="next" href="libxml-xmlreader.html" title="xmlreader"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlexports.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlreader.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xinclude"></a><div class="titlepage"></div><div class="refnamediv"><h2>xinclude</h2><p>xinclude &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2761503"></a>Synopsis</h1></h2><pre class="synopsis">
@ -42,6 +42,12 @@
#define <a href="libxml-xinclude.html#XINCLUDE-PARSE-ENCODING-CAPS">XINCLUDE_PARSE_ENCODING</a>
struct <a href="libxml-xinclude.html#xmlXIncludeCtxt">xmlXIncludeCtxt</a>;
typedef <a href="libxml-xinclude.html#xmlXIncludeCtxtPtr">xmlXIncludeCtxtPtr</a>;
int <a href="libxml-xinclude.html#xmlXIncludeProcess">xmlXIncludeProcess</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
int <a href="libxml-xinclude.html#xmlXIncludeProcessTree">xmlXIncludeProcessTree</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> tree);
<a href="libxml-xinclude.html#xmlXIncludeCtxtPtr">xmlXIncludeCtxtPtr</a> <a href="libxml-xinclude.html#xmlXIncludeNewContext">xmlXIncludeNewContext</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
void <a href="libxml-xinclude.html#xmlXIncludeFreeContext">xmlXIncludeFreeContext</a> (<a href="libxml-xinclude.html#xmlXIncludeCtxtPtr">xmlXIncludeCtxtPtr</a> ctxt);
int <a href="libxml-xinclude.html#xmlXIncludeProcessNode">xmlXIncludeProcessNode</a> (<a href="libxml-xinclude.html#xmlXIncludeCtxtPtr">xmlXIncludeCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> tree);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="XINCLUDE-NS-CAPS"></a>XINCLUDE_NS</h3><pre class="programlisting">#define XINCLUDE_NS (const xmlChar *) "http://www.w3.org/2001/XInclude"
@ -73,4 +79,34 @@ typedef <a href="libxml-xinclude.html#xmlXIncludeCtxtPtr">xmlXIncludeCtxtPtr
</p></div><hr><div class="refsect2"><h3><a name="xmlXIncludeCtxtPtr"></a>xmlXIncludeCtxtPtr</h3><pre class="programlisting">typedef xmlXIncludeCtxt *xmlXIncludeCtxtPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlexports.html"><b>&lt;&lt; xmlexports</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlreader.html"><b>xmlreader &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlXIncludeProcess"></a>xmlXIncludeProcess ()</h3><pre class="programlisting">int xmlXIncludeProcess (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Implement the XInclude substitution on the XML document <i><tt>doc</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> an XML document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if no substitution were done, -1 if some processing failed
or the number of substitutions done.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXIncludeProcessTree"></a>xmlXIncludeProcessTree ()</h3><pre class="programlisting">int xmlXIncludeProcessTree (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> tree);</pre><p>
Implement the XInclude substitution for the given subtree</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>tree</tt></i>:</span></td><td> a node in an XML document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if no substitution were done, -1 if some processing failed
or the number of substitutions done.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXIncludeNewContext"></a>xmlXIncludeNewContext ()</h3><pre class="programlisting"><a href="libxml-xinclude.html#xmlXIncludeCtxtPtr">xmlXIncludeCtxtPtr</a> xmlXIncludeNewContext (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Creates a new XInclude context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> an XML Document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new set
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXIncludeFreeContext"></a>xmlXIncludeFreeContext ()</h3><pre class="programlisting">void xmlXIncludeFreeContext (<a href="libxml-xinclude.html#xmlXIncludeCtxtPtr">xmlXIncludeCtxtPtr</a> ctxt);</pre><p>
Free an XInclude context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the XInclude context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXIncludeProcessNode"></a>xmlXIncludeProcessNode ()</h3><pre class="programlisting">int xmlXIncludeProcessNode (<a href="libxml-xinclude.html#xmlXIncludeCtxtPtr">xmlXIncludeCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> tree);</pre><p>
Implement the XInclude substitution for the given subtree reusing
the informations and data coming from the given context.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an existing XInclude context
</td></tr><tr><td><span class="term"><i><tt>tree</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if no substitution were done, -1 if some processing failed
or the number of substitutions done.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlexports.html"><b>&lt;&lt; xmlexports</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlreader.html"><b>xmlreader &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlmemory.html" title="xmlmemory"><link rel="next" href="libxml-xpath.html" title="xpath"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlmemory.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xpath.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlIO"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlIO</h2><p>xmlIO &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2609940"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlmemory.html" title="xmlmemory"><link rel="next" href="libxml-xpath.html" title="xpath"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlmemory.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xpath.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlIO"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlIO</h2><p>xmlIO &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2590417"></a>Synopsis</h1></h2><pre class="synopsis">
@ -46,6 +46,103 @@ int (<a href="libxml-xmlIO.html#xmlOutputWriteCallback">*xmlOutputWriteC
int (<a href="libxml-xmlIO.html#xmlOutputCloseCallback">*xmlOutputCloseCallback</a>) (void *context);
struct <a href="libxml-xmlIO.html#xmlParserInputBuffer">xmlParserInputBuffer</a>;
struct <a href="libxml-xmlIO.html#xmlOutputBuffer">xmlOutputBuffer</a>;
void <a href="libxml-xmlIO.html#xmlCleanupInputCallbacks">xmlCleanupInputCallbacks</a> (void);
void <a href="libxml-xmlIO.html#xmlRegisterDefaultInputCallbacks">xmlRegisterDefaultInputCallbacks</a>
(void);
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> <a href="libxml-xmlIO.html#xmlAllocParserInputBuffer">xmlAllocParserInputBuffer</a>
(<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> <a href="libxml-xmlIO.html#xmlParserInputBufferCreateFilename">xmlParserInputBufferCreateFilename</a>
(const char *URI,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> <a href="libxml-xmlIO.html#xmlParserInputBufferCreateFile">xmlParserInputBufferCreateFile</a>
(<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *file,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> <a href="libxml-xmlIO.html#xmlParserInputBufferCreateFd">xmlParserInputBufferCreateFd</a>
(int fd,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> <a href="libxml-xmlIO.html#xmlParserInputBufferCreateMem">xmlParserInputBufferCreateMem</a>
(const char *mem,
int size,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> <a href="libxml-xmlIO.html#xmlParserInputBufferCreateStatic">xmlParserInputBufferCreateStatic</a>
(const char *mem,
int size,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> <a href="libxml-xmlIO.html#xmlParserInputBufferCreateIO">xmlParserInputBufferCreateIO</a>
(<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);
int <a href="libxml-xmlIO.html#xmlParserInputBufferRead">xmlParserInputBufferRead</a> (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> in,
int len);
int <a href="libxml-xmlIO.html#xmlParserInputBufferGrow">xmlParserInputBufferGrow</a> (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> in,
int len);
int <a href="libxml-xmlIO.html#xmlParserInputBufferPush">xmlParserInputBufferPush</a> (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> in,
int len,
const char *buf);
void <a href="libxml-xmlIO.html#xmlFreeParserInputBuffer">xmlFreeParserInputBuffer</a> (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> in);
char* <a href="libxml-xmlIO.html#xmlParserGetDirectory">xmlParserGetDirectory</a> (const char *filename);
int <a href="libxml-xmlIO.html#xmlRegisterInputCallbacks">xmlRegisterInputCallbacks</a> (<a href="libxml-xmlIO.html#xmlInputMatchCallback">xmlInputMatchCallback</a> matchFunc,
<a href="libxml-xmlIO.html#xmlInputOpenCallback">xmlInputOpenCallback</a> openFunc,
<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> readFunc,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> closeFunc);
void <a href="libxml-xmlIO.html#xmlCleanupOutputCallbacks">xmlCleanupOutputCallbacks</a> (void);
void <a href="libxml-xmlIO.html#xmlRegisterDefaultOutputCallbacks">xmlRegisterDefaultOutputCallbacks</a>
(void);
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> <a href="libxml-xmlIO.html#xmlAllocOutputBuffer">xmlAllocOutputBuffer</a> (<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder);
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> <a href="libxml-xmlIO.html#xmlOutputBufferCreateFilename">xmlOutputBufferCreateFilename</a>
(const char *URI,
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder,
int compression);
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> <a href="libxml-xmlIO.html#xmlOutputBufferCreateFile">xmlOutputBufferCreateFile</a>
(<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *file,
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder);
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> <a href="libxml-xmlIO.html#xmlOutputBufferCreateFd">xmlOutputBufferCreateFd</a> (int fd,
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder);
<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> <a href="libxml-xmlIO.html#xmlOutputBufferCreateIO">xmlOutputBufferCreateIO</a> (<a href="libxml-xmlIO.html#xmlOutputWriteCallback">xmlOutputWriteCallback</a> iowrite,
<a href="libxml-xmlIO.html#xmlOutputCloseCallback">xmlOutputCloseCallback</a> ioclose,
void *ioctx,
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder);
int <a href="libxml-xmlIO.html#xmlOutputBufferWrite">xmlOutputBufferWrite</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out,
int len,
const char *buf);
int <a href="libxml-xmlIO.html#xmlOutputBufferWriteString">xmlOutputBufferWriteString</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out,
const char *str);
int <a href="libxml-xmlIO.html#xmlOutputBufferFlush">xmlOutputBufferFlush</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out);
int <a href="libxml-xmlIO.html#xmlOutputBufferClose">xmlOutputBufferClose</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out);
int <a href="libxml-xmlIO.html#xmlRegisterOutputCallbacks">xmlRegisterOutputCallbacks</a> (<a href="libxml-xmlIO.html#xmlOutputMatchCallback">xmlOutputMatchCallback</a> matchFunc,
<a href="libxml-xmlIO.html#xmlOutputOpenCallback">xmlOutputOpenCallback</a> openFunc,
<a href="libxml-xmlIO.html#xmlOutputWriteCallback">xmlOutputWriteCallback</a> writeFunc,
<a href="libxml-xmlIO.html#xmlOutputCloseCallback">xmlOutputCloseCallback</a> closeFunc);
void* <a href="libxml-xmlIO.html#xmlIOHTTPOpenW">xmlIOHTTPOpenW</a> (const char *post_uri,
int compression);
void <a href="libxml-xmlIO.html#xmlRegisterHTTPPostCallbacks">xmlRegisterHTTPPostCallbacks</a> (void);
<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> <a href="libxml-xmlIO.html#xmlCheckHTTPInput">xmlCheckHTTPInput</a> (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> ret);
<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> <a href="libxml-xmlIO.html#xmlNoNetExternalEntityLoader">xmlNoNetExternalEntityLoader</a>
(const char *URL,
const char *ID,
<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlIO.html#xmlNormalizeWindowsPath">xmlNormalizeWindowsPath</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *path);
int <a href="libxml-xmlIO.html#xmlCheckFilename">xmlCheckFilename</a> (const char *path);
int <a href="libxml-xmlIO.html#xmlFileMatch">xmlFileMatch</a> (const char *filename);
void* <a href="libxml-xmlIO.html#xmlFileOpen">xmlFileOpen</a> (const char *filename);
int <a href="libxml-xmlIO.html#xmlFileRead">xmlFileRead</a> (void *context,
char *buffer,
int len);
int <a href="libxml-xmlIO.html#xmlFileClose">xmlFileClose</a> (void *context);
int <a href="libxml-xmlIO.html#xmlIOHTTPMatch">xmlIOHTTPMatch</a> (const char *filename);
void* <a href="libxml-xmlIO.html#xmlIOHTTPOpen">xmlIOHTTPOpen</a> (const char *filename);
int <a href="libxml-xmlIO.html#xmlIOHTTPRead">xmlIOHTTPRead</a> (void *context,
char *buffer,
int len);
int <a href="libxml-xmlIO.html#xmlIOHTTPClose">xmlIOHTTPClose</a> (void *context);
int <a href="libxml-xmlIO.html#xmlIOFTPMatch">xmlIOFTPMatch</a> (const char *filename);
void* <a href="libxml-xmlIO.html#xmlIOFTPOpen">xmlIOFTPOpen</a> (const char *filename);
int <a href="libxml-xmlIO.html#xmlIOFTPRead">xmlIOFTPRead</a> (void *context,
char *buffer,
int len);
int <a href="libxml-xmlIO.html#xmlIOFTPClose">xmlIOFTPClose</a> (void *context);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlInputMatchCallback"></a>xmlInputMatchCallback ()</h3><pre class="programlisting">int (*xmlInputMatchCallback) (char const *filename);</pre><p>
@ -126,4 +223,363 @@ Callback used in the I/O Output API to close the resource</p><p>
};
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlmemory.html"><b>&lt;&lt; xmlmemory</b></a></td><td align="right"><a accesskey="n" href="libxml-xpath.html"><b>xpath &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlCleanupInputCallbacks"></a>xmlCleanupInputCallbacks ()</h3><pre class="programlisting">void xmlCleanupInputCallbacks (void);</pre><p>
clears the entire input callback table. this includes the
compiled-in I/O.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlRegisterDefaultInputCallbacks"></a>xmlRegisterDefaultInputCallbacks ()</h3><pre class="programlisting">void xmlRegisterDefaultInputCallbacks
(void);</pre><p>
Registers the default compiled-in I/O handlers.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlAllocParserInputBuffer"></a>xmlAllocParserInputBuffer ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> xmlAllocParserInputBuffer
(<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a buffered parser input for progressive parsing</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> the charset encoding if known
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser input or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferCreateFilename"></a>xmlParserInputBufferCreateFilename ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> xmlParserInputBufferCreateFilename
(const char *URI,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a buffered parser input for the progressive parsing of a file
If filename is "-' then we use stdin as the input.
Automatic support for ZLIB/Compress compressed document is provided
by default if found at compile-time.
Do an encoding check if enc == XML_CHAR_ENCODING_NONE</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> a C string containing the URI or filename
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> the charset encoding if known
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser input or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferCreateFile"></a>xmlParserInputBufferCreateFile ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> xmlParserInputBufferCreateFile
(<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *file,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a buffered parser input for the progressive parsing of a FILE *
buffered C I/O</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>file</tt></i>:</span></td><td> a FILE*
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> the charset encoding if known
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser input or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferCreateFd"></a>xmlParserInputBufferCreateFd ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> xmlParserInputBufferCreateFd
(int fd,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a buffered parser input for the progressive parsing for the input
from a file descriptor</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>fd</tt></i>:</span></td><td> a file descriptor number
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> the charset encoding if known
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser input or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferCreateMem"></a>xmlParserInputBufferCreateMem ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> xmlParserInputBufferCreateMem
(const char *mem,
int size,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a buffered parser input for the progressive parsing for the input
from a memory area.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>mem</tt></i>:</span></td><td> the memory input
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the length of the memory block
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> the charset encoding if known
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser input or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferCreateStatic"></a>xmlParserInputBufferCreateStatic ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> xmlParserInputBufferCreateStatic
(const char *mem,
int size,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a buffered parser input for the progressive parsing for the input
from an immutable memory area. This will not copy the memory area to
the buffer, but the memory is expected to be available until the end of
the parsing, this is useful for example when using mmap'ed file.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>mem</tt></i>:</span></td><td> the memory input
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the length of the memory block
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> the charset encoding if known
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser input or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferCreateIO"></a>xmlParserInputBufferCreateIO ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> xmlParserInputBufferCreateIO
(<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc);</pre><p>
Create a buffered parser input for the progressive parsing for the input
from an I/O handler</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ioread</tt></i>:</span></td><td> an I/O read function
</td></tr><tr><td><span class="term"><i><tt>ioclose</tt></i>:</span></td><td> an I/O close function
</td></tr><tr><td><span class="term"><i><tt>ioctx</tt></i>:</span></td><td> an I/O handler
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> the charset encoding if known
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser input or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferRead"></a>xmlParserInputBufferRead ()</h3><pre class="programlisting">int xmlParserInputBufferRead (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> in,
int len);</pre><p>
Refresh the content of the input buffer, the old data are considered
consumed
This routine handle the I18N transcoding to internal UTF-8</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a buffered parser input
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> indicative value of the amount of chars to read
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of chars read and stored in the buffer, or -1
in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferGrow"></a>xmlParserInputBufferGrow ()</h3><pre class="programlisting">int xmlParserInputBufferGrow (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> in,
int len);</pre><p>
Grow up the content of the input buffer, the old data are preserved
This routine handle the I18N transcoding to internal UTF-8
This routine is used when operating the parser in normal (pull) mode
</p><p>
TODO: one should be able to remove one extra copy by copying directly
onto in-&gt;buffer or in-&gt;raw</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a buffered parser input
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> indicative value of the amount of chars to read
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of chars read and stored in the buffer, or -1
in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserInputBufferPush"></a>xmlParserInputBufferPush ()</h3><pre class="programlisting">int xmlParserInputBufferPush (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> in,
int len,
const char *buf);</pre><p>
Push the content of the arry in the input buffer
This routine handle the I18N transcoding to internal UTF-8
This is used when operating the parser in progressive (push) mode.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a buffered parser input
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the size in bytes of the array.
</td></tr><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> an char array
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of chars read and stored in the buffer, or -1
in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeParserInputBuffer"></a>xmlFreeParserInputBuffer ()</h3><pre class="programlisting">void xmlFreeParserInputBuffer (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> in);</pre><p>
Free up the memory used by a buffered parser input</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>in</tt></i>:</span></td><td> a buffered parser input
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserGetDirectory"></a>xmlParserGetDirectory ()</h3><pre class="programlisting">char* xmlParserGetDirectory (const char *filename);</pre><p>
lookup the directory for that file</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the path to a file
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new allocated string containing the directory, or NULL.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegisterInputCallbacks"></a>xmlRegisterInputCallbacks ()</h3><pre class="programlisting">int xmlRegisterInputCallbacks (<a href="libxml-xmlIO.html#xmlInputMatchCallback">xmlInputMatchCallback</a> matchFunc,
<a href="libxml-xmlIO.html#xmlInputOpenCallback">xmlInputOpenCallback</a> openFunc,
<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> readFunc,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> closeFunc);</pre><p>
Register a new set of I/O callback for handling parser input.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>matchFunc</tt></i>:</span></td><td> the xmlInputMatchCallback
</td></tr><tr><td><span class="term"><i><tt>openFunc</tt></i>:</span></td><td> the xmlInputOpenCallback
</td></tr><tr><td><span class="term"><i><tt>readFunc</tt></i>:</span></td><td> the xmlInputReadCallback
</td></tr><tr><td><span class="term"><i><tt>closeFunc</tt></i>:</span></td><td> the xmlInputCloseCallback
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the registered handler number or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCleanupOutputCallbacks"></a>xmlCleanupOutputCallbacks ()</h3><pre class="programlisting">void xmlCleanupOutputCallbacks (void);</pre><p>
clears the entire output callback table. this includes the
compiled-in I/O callbacks.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlRegisterDefaultOutputCallbacks"></a>xmlRegisterDefaultOutputCallbacks ()</h3><pre class="programlisting">void xmlRegisterDefaultOutputCallbacks
(void);</pre><p>
Registers the default compiled-in I/O handlers.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlAllocOutputBuffer"></a>xmlAllocOutputBuffer ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> xmlAllocOutputBuffer (<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder);</pre><p>
Create a buffered parser output</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>encoder</tt></i>:</span></td><td> the encoding converter or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser output or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlOutputBufferCreateFilename"></a>xmlOutputBufferCreateFilename ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> xmlOutputBufferCreateFilename
(const char *URI,
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder,
int compression);</pre><p>
Create a buffered output for the progressive saving of a file
If filename is "-' then we use stdout as the output.
Automatic support for ZLIB/Compress compressed document is provided
by default if found at compile-time.
TODO: currently if compression is set, the library only support
writing to a local file.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> a C string containing the URI or filename
</td></tr><tr><td><span class="term"><i><tt>encoder</tt></i>:</span></td><td> the encoding converter or NULL
</td></tr><tr><td><span class="term"><i><tt>compression</tt></i>:</span></td><td> the compression ration (0 none, 9 max).
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new output or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlOutputBufferCreateFile"></a>xmlOutputBufferCreateFile ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> xmlOutputBufferCreateFile
(<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *file,
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder);</pre><p>
Create a buffered output for the progressive saving to a FILE *
buffered C I/O</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>file</tt></i>:</span></td><td> a FILE*
</td></tr><tr><td><span class="term"><i><tt>encoder</tt></i>:</span></td><td> the encoding converter or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser output or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlOutputBufferCreateFd"></a>xmlOutputBufferCreateFd ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> xmlOutputBufferCreateFd (int fd,
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder);</pre><p>
Create a buffered output for the progressive saving
to a file descriptor</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>fd</tt></i>:</span></td><td> a file descriptor number
</td></tr><tr><td><span class="term"><i><tt>encoder</tt></i>:</span></td><td> the encoding converter or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser output or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlOutputBufferCreateIO"></a>xmlOutputBufferCreateIO ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> xmlOutputBufferCreateIO (<a href="libxml-xmlIO.html#xmlOutputWriteCallback">xmlOutputWriteCallback</a> iowrite,
<a href="libxml-xmlIO.html#xmlOutputCloseCallback">xmlOutputCloseCallback</a> ioclose,
void *ioctx,
<a href="libxml-encoding.html#xmlCharEncodingHandlerPtr">xmlCharEncodingHandlerPtr</a> encoder);</pre><p>
Create a buffered output for the progressive saving
to an I/O handler</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>iowrite</tt></i>:</span></td><td> an I/O write function
</td></tr><tr><td><span class="term"><i><tt>ioclose</tt></i>:</span></td><td> an I/O close function
</td></tr><tr><td><span class="term"><i><tt>ioctx</tt></i>:</span></td><td> an I/O handler
</td></tr><tr><td><span class="term"><i><tt>encoder</tt></i>:</span></td><td> the charset encoding if known
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new parser output or NULL
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlOutputBufferWrite"></a>xmlOutputBufferWrite ()</h3><pre class="programlisting">int xmlOutputBufferWrite (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out,
int len,
const char *buf);</pre><p>
Write the content of the array in the output I/O buffer
This routine handle the I18N transcoding from internal UTF-8
The buffer is lossless, i.e. will store in case of partial
or delayed writes.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a buffered parser output
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the size in bytes of the array.
</td></tr><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> an char array
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of chars immediately written, or -1
in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlOutputBufferWriteString"></a>xmlOutputBufferWriteString ()</h3><pre class="programlisting">int xmlOutputBufferWriteString (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out,
const char *str);</pre><p>
Write the content of the string in the output I/O buffer
This routine handle the I18N transcoding from internal UTF-8
The buffer is lossless, i.e. will store in case of partial
or delayed writes.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a buffered parser output
</td></tr><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> a zero terminated C string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of chars immediately written, or -1
in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlOutputBufferFlush"></a>xmlOutputBufferFlush ()</h3><pre class="programlisting">int xmlOutputBufferFlush (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out);</pre><p>
flushes the output I/O channel</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a buffered output
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte written or -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlOutputBufferClose"></a>xmlOutputBufferClose ()</h3><pre class="programlisting">int xmlOutputBufferClose (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out);</pre><p>
flushes and close the output I/O channel
and free up all the associated resources</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> a buffered output
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of byte written or -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegisterOutputCallbacks"></a>xmlRegisterOutputCallbacks ()</h3><pre class="programlisting">int xmlRegisterOutputCallbacks (<a href="libxml-xmlIO.html#xmlOutputMatchCallback">xmlOutputMatchCallback</a> matchFunc,
<a href="libxml-xmlIO.html#xmlOutputOpenCallback">xmlOutputOpenCallback</a> openFunc,
<a href="libxml-xmlIO.html#xmlOutputWriteCallback">xmlOutputWriteCallback</a> writeFunc,
<a href="libxml-xmlIO.html#xmlOutputCloseCallback">xmlOutputCloseCallback</a> closeFunc);</pre><p>
Register a new set of I/O callback for handling output.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>matchFunc</tt></i>:</span></td><td> the xmlOutputMatchCallback
</td></tr><tr><td><span class="term"><i><tt>openFunc</tt></i>:</span></td><td> the xmlOutputOpenCallback
</td></tr><tr><td><span class="term"><i><tt>writeFunc</tt></i>:</span></td><td> the xmlOutputWriteCallback
</td></tr><tr><td><span class="term"><i><tt>closeFunc</tt></i>:</span></td><td> the xmlOutputCloseCallback
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the registered handler number or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOHTTPOpenW"></a>xmlIOHTTPOpenW ()</h3><pre class="programlisting">void* xmlIOHTTPOpenW (const char *post_uri,
int compression);</pre><p>
Open a temporary buffer to collect the document for a subsequent HTTP POST
request. Non-static as is called from the output buffer creation routine.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>post_uri</tt></i>:</span></td><td> The destination URI for the document
</td></tr><tr><td><span class="term"><i><tt>compression</tt></i>:</span></td><td> The compression desired for the document.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegisterHTTPPostCallbacks"></a>xmlRegisterHTTPPostCallbacks ()</h3><pre class="programlisting">void xmlRegisterHTTPPostCallbacks (void);</pre><p>
By default, libxml submits HTTP output requests using the "PUT" method.
Calling this method changes the HTTP output method to use the "POST"
method instead.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlCheckHTTPInput"></a>xmlCheckHTTPInput ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> xmlCheckHTTPInput (<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> ret);</pre><p>
Check an input in case it was created from an HTTP stream, in that
case it will handle encoding and update of the base URL in case of
redirection. It also checks for HTTP errors in which case the input
is cleanly freed up and an appropriate error is raised in context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> an XML parser context
</td></tr><tr><td><span class="term"><i><tt>ret</tt></i>:</span></td><td> an XML parser input
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the input or NULL in case of HTTP error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNoNetExternalEntityLoader"></a>xmlNoNetExternalEntityLoader ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> xmlNoNetExternalEntityLoader
(const char *URL,
const char *ID,
<a href="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt);</pre><p>
A specific entity loader disabling network accesses, though still
allowing local catalog accesses for resolution.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the URL for the entity to load
</td></tr><tr><td><span class="term"><i><tt>ID</tt></i>:</span></td><td> the System ID for the entity to load
</td></tr><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the context in which the entity is called or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a new allocated xmlParserInputPtr, or NULL.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNormalizeWindowsPath"></a>xmlNormalizeWindowsPath ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlNormalizeWindowsPath (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *path);</pre><p>
This function is obsolete. Please see xmlURIFromPath in uri.c for
a better solution.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>path</tt></i>:</span></td><td> the input file path
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a canonicalized version of the path
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCheckFilename"></a>xmlCheckFilename ()</h3><pre class="programlisting">int xmlCheckFilename (const char *path);</pre><p>
function checks to see if <i><tt>path</tt></i> is a valid source
(file, socket...) for XML.
</p><p>
if stat is not available on the target machine,
returns 1. if stat fails, returns 0 (if calling
stat on the filename fails, it can't be right).
if stat succeeds and the file is a directory,</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>path</tt></i>:</span></td><td> the path to check
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>2. otherwise returns 1.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFileMatch"></a>xmlFileMatch ()</h3><pre class="programlisting">int xmlFileMatch (const char *filename);</pre><p>
input from FILE *</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the URI for matching
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if matches, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFileOpen"></a>xmlFileOpen ()</h3><pre class="programlisting">void* xmlFileOpen (const char *filename);</pre><p>
Wrapper around xmlFileOpen_real that try it with an unescaped
version of <i><tt>filename</tt></i>, if this fails fallback to <i><tt>filename</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the URI for matching
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFileRead"></a>xmlFileRead ()</h3><pre class="programlisting">int xmlFileRead (void *context,
char *buffer,
int len);</pre><p>
Read <i><tt>len</tt></i> bytes to <i><tt>buffer</tt></i> from the I/O channel.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>context</tt></i>:</span></td><td> the I/O context
</td></tr><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> where to drop data
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> number of bytes to write
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of bytes written
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFileClose"></a>xmlFileClose ()</h3><pre class="programlisting">int xmlFileClose (void *context);</pre><p>
Close an I/O channel</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>context</tt></i>:</span></td><td> the I/O context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOHTTPMatch"></a>xmlIOHTTPMatch ()</h3><pre class="programlisting">int xmlIOHTTPMatch (const char *filename);</pre><p>
check if the URI matches an HTTP one</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the URI for matching
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if matches, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOHTTPOpen"></a>xmlIOHTTPOpen ()</h3><pre class="programlisting">void* xmlIOHTTPOpen (const char *filename);</pre><p>
open an HTTP I/O channel</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the URI for matching
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOHTTPRead"></a>xmlIOHTTPRead ()</h3><pre class="programlisting">int xmlIOHTTPRead (void *context,
char *buffer,
int len);</pre><p>
Read <i><tt>len</tt></i> bytes to <i><tt>buffer</tt></i> from the I/O channel.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>context</tt></i>:</span></td><td> the I/O context
</td></tr><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> where to drop data
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> number of bytes to write
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of bytes written
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOHTTPClose"></a>xmlIOHTTPClose ()</h3><pre class="programlisting">int xmlIOHTTPClose (void *context);</pre><p>
Close an HTTP I/O channel</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>context</tt></i>:</span></td><td> the I/O context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOFTPMatch"></a>xmlIOFTPMatch ()</h3><pre class="programlisting">int xmlIOFTPMatch (const char *filename);</pre><p>
check if the URI matches an FTP one</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the URI for matching
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if matches, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOFTPOpen"></a>xmlIOFTPOpen ()</h3><pre class="programlisting">void* xmlIOFTPOpen (const char *filename);</pre><p>
open an FTP I/O channel</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> the URI for matching
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOFTPRead"></a>xmlIOFTPRead ()</h3><pre class="programlisting">int xmlIOFTPRead (void *context,
char *buffer,
int len);</pre><p>
Read <i><tt>len</tt></i> bytes to <i><tt>buffer</tt></i> from the I/O channel.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>context</tt></i>:</span></td><td> the I/O context
</td></tr><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> where to drop data
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> number of bytes to write
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of bytes written
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlIOFTPClose"></a>xmlIOFTPClose ()</h3><pre class="programlisting">int xmlIOFTPClose (void *context);</pre><p>
Close an FTP I/O channel</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>context</tt></i>:</span></td><td> the I/O context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlmemory.html"><b>&lt;&lt; xmlmemory</b></a></td><td align="right"><a accesskey="n" href="libxml-xpath.html"><b>xpath &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-dict.html" title="dict"><link rel="next" href="libxml-xpointer.html" title="xpointer"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-dict.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xpointer.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlautomata"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlautomata</h2><p>xmlautomata &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2652960"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-dict.html" title="dict"><link rel="next" href="libxml-xmlschemastypes.html" title="xmlschemastypes"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-dict.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlschemastypes.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlautomata"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlautomata</h2><p>xmlautomata &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2645506"></a>Synopsis</h1></h2><pre class="synopsis">
@ -36,6 +36,62 @@ struct <a href="libxml-xmlautomata.html#xmlAutomata">xmlAutomata</a>;
typedef <a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a>;
struct <a href="libxml-xmlautomata.html#xmlAutomataState">xmlAutomataState</a>;
typedef <a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a>;
<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> <a href="libxml-xmlautomata.html#xmlNewAutomata">xmlNewAutomata</a> (void);
void <a href="libxml-xmlautomata.html#xmlFreeAutomata">xmlFreeAutomata</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataGetInitState">xmlAutomataGetInitState</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);
int <a href="libxml-xmlautomata.html#xmlAutomataSetFinalState">xmlAutomataSetFinalState</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> state);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewState">xmlAutomataNewState</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewTransition">xmlAutomataNewTransition</a>
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
void *data);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewTransition2">xmlAutomataNewTransition2</a>
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token2,
void *data);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewCountTrans">xmlAutomataNewCountTrans</a>
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
int min,
int max,
void *data);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewOnceTrans">xmlAutomataNewOnceTrans</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
int min,
int max,
void *data);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewAllTrans">xmlAutomataNewAllTrans</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
int lax);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewEpsilon">xmlAutomataNewEpsilon</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewCountedTrans">xmlAutomataNewCountedTrans</a>
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
int counter);
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> <a href="libxml-xmlautomata.html#xmlAutomataNewCounterTrans">xmlAutomataNewCounterTrans</a>
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
int counter);
int <a href="libxml-xmlautomata.html#xmlAutomataNewCounter">xmlAutomataNewCounter</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
int min,
int max);
<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> <a href="libxml-xmlautomata.html#xmlAutomataCompile">xmlAutomataCompile</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);
int <a href="libxml-xmlautomata.html#xmlAutomataIsDeterminist">xmlAutomataIsDeterminist</a> (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlAutomata"></a>struct xmlAutomata</h3><pre class="programlisting">struct xmlAutomata;</pre><p>
@ -50,4 +106,178 @@ A libxml automata description, It can be compiled into a regexp</p><p>
</pre><p>
A state int the automata description,</p><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-dict.html"><b>&lt;&lt; dict</b></a></td><td align="right"><a accesskey="n" href="libxml-xpointer.html"><b>xpointer &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlNewAutomata"></a>xmlNewAutomata ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> xmlNewAutomata (void);</pre><p>
Create a new automata</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new object or NULL in case of failure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeAutomata"></a>xmlFreeAutomata ()</h3><pre class="programlisting">void xmlFreeAutomata (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);</pre><p>
Free an automata</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataGetInitState"></a>xmlAutomataGetInitState ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataGetInitState (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);</pre><p>
Initial state lookup</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the initial state of the automata
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataSetFinalState"></a>xmlAutomataSetFinalState ()</h3><pre class="programlisting">int xmlAutomataSetFinalState (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> state);</pre><p>
Makes that state a final state</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>state</tt></i>:</span></td><td> a state in this automata
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewState"></a>xmlAutomataNewState ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewState (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);</pre><p>
Create a new disconnected state in the automata</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewTransition"></a>xmlAutomataNewTransition ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewTransition
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
void *data);</pre><p>
If <i><tt>to</tt></i> is NULL, this create first a new target state in the automata
and then adds a transition from the <i><tt>from</tt></i> state to the target state
activated by the value of <i><tt>token</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> the starting point of the transition
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> the target point of the transition or NULL
</td></tr><tr><td><span class="term"><i><tt>token</tt></i>:</span></td><td> the input string associated to that transition
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> data passed to the callback function if the transition is activated
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the target state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewTransition2"></a>xmlAutomataNewTransition2 ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewTransition2
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token2,
void *data);</pre><p>
If <i><tt>to</tt></i> is NULL, this create first a new target state in the automata
and then adds a transition from the <i><tt>from</tt></i> state to the target state
activated by the value of <i><tt>token</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> the starting point of the transition
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> the target point of the transition or NULL
</td></tr><tr><td><span class="term"><i><tt>token</tt></i>:</span></td><td> the first input string associated to that transition
</td></tr><tr><td><span class="term"><i><tt>token2</tt></i>:</span></td><td> the second input string associated to that transition
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> data passed to the callback function if the transition is activated
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the target state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewCountTrans"></a>xmlAutomataNewCountTrans ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewCountTrans
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
int min,
int max,
void *data);</pre><p>
If <i><tt>to</tt></i> is NULL, this create first a new target state in the automata
and then adds a transition from the <i><tt>from</tt></i> state to the target state
activated by a succession of input of value <i><tt>token</tt></i> and whose number
is between <i><tt>min</tt></i> and <i><tt>max</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> the starting point of the transition
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> the target point of the transition or NULL
</td></tr><tr><td><span class="term"><i><tt>token</tt></i>:</span></td><td> the input string associated to that transition
</td></tr><tr><td><span class="term"><i><tt>min</tt></i>:</span></td><td> the minimum successive occurences of token
</td></tr><tr><td><span class="term"><i><tt>max</tt></i>:</span></td><td> the maximum successive occurences of token
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> data associated to the transition
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the target state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewOnceTrans"></a>xmlAutomataNewOnceTrans ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewOnceTrans (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
int min,
int max,
void *data);</pre><p>
If <i><tt>to</tt></i> is NULL, this create first a new target state in the automata
and then adds a transition from the <i><tt>from</tt></i> state to the target state
activated by a succession of input of value <i><tt>token</tt></i> and whose number
is between <i><tt>min</tt></i> and <i><tt>max</tt></i>, moreover that transistion can only be crossed
once.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> the starting point of the transition
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> the target point of the transition or NULL
</td></tr><tr><td><span class="term"><i><tt>token</tt></i>:</span></td><td> the input string associated to that transition
</td></tr><tr><td><span class="term"><i><tt>min</tt></i>:</span></td><td> the minimum successive occurences of token
</td></tr><tr><td><span class="term"><i><tt>max</tt></i>:</span></td><td> the maximum successive occurences of token
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> data associated to the transition
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the target state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewAllTrans"></a>xmlAutomataNewAllTrans ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewAllTrans (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
int lax);</pre><p>
If <i><tt>to</tt></i> is NULL, this create first a new target state in the automata
and then adds a an ALL transition from the <i><tt>from</tt></i> state to the
target state. That transition is an epsilon transition allowed only when
all transitions from the <i><tt>from</tt></i> node have been activated.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> the starting point of the transition
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> the target point of the transition or NULL
</td></tr><tr><td><span class="term"><i><tt>lax</tt></i>:</span></td><td> allow to transition if not all all transitions have been activated
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the target state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewEpsilon"></a>xmlAutomataNewEpsilon ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewEpsilon (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to);</pre><p>
If <i><tt>to</tt></i> is NULL, this create first a new target state in the automata
and then adds a an epsilon transition from the <i><tt>from</tt></i> state to the
target state</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> the starting point of the transition
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> the target point of the transition or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the target state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewCountedTrans"></a>xmlAutomataNewCountedTrans ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewCountedTrans
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
int counter);</pre><p>
If <i><tt>to</tt></i> is NULL, this create first a new target state in the automata
and then adds an epsilon transition from the <i><tt>from</tt></i> state to the target state
which will increment the counter provided</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> the starting point of the transition
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> the target point of the transition or NULL
</td></tr><tr><td><span class="term"><i><tt>counter</tt></i>:</span></td><td> the counter associated to that transition
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the target state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewCounterTrans"></a>xmlAutomataNewCounterTrans ()</h3><pre class="programlisting"><a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> xmlAutomataNewCounterTrans
(<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> from,
<a href="libxml-xmlautomata.html#xmlAutomataStatePtr">xmlAutomataStatePtr</a> to,
int counter);</pre><p>
If <i><tt>to</tt></i> is NULL, this create first a new target state in the automata
and then adds an epsilon transition from the <i><tt>from</tt></i> state to the target state
which will be allowed only if the counter is within the right range.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> the starting point of the transition
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> the target point of the transition or NULL
</td></tr><tr><td><span class="term"><i><tt>counter</tt></i>:</span></td><td> the counter associated to that transition
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the target state or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataNewCounter"></a>xmlAutomataNewCounter ()</h3><pre class="programlisting">int xmlAutomataNewCounter (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am,
int min,
int max);</pre><p>
Create a new counter</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><i><tt>min</tt></i>:</span></td><td> the minimal value on the counter
</td></tr><tr><td><span class="term"><i><tt>max</tt></i>:</span></td><td> the maximal value on the counter
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the counter number or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataCompile"></a>xmlAutomataCompile ()</h3><pre class="programlisting"><a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> xmlAutomataCompile (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);</pre><p>
Compile the automata into a Reg Exp ready for being executed.
The automata should be free after this point.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the compiled regexp or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlAutomataIsDeterminist"></a>xmlAutomataIsDeterminist ()</h3><pre class="programlisting">int xmlAutomataIsDeterminist (<a href="libxml-xmlautomata.html#xmlAutomataPtr">xmlAutomataPtr</a> am);</pre><p>
Checks if an automata is determinist.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>am</tt></i>:</span></td><td> an automata
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true, 0 if not, and -1 in case of error
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-dict.html"><b>&lt;&lt; dict</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlschemastypes.html"><b>xmlschemastypes &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-c14n.html" title="c14n"><link rel="next" href="libxml-xmlwin32version.html" title="xmlwin32version"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-c14n.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlwin32version.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlerror"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlerror</h2><p>xmlerror &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2601275"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-c14n.html" title="c14n"><link rel="next" href="libxml-xmlwin32version.html" title="xmlwin32version"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-c14n.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlwin32version.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlerror"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlerror</h2><p>xmlerror &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2716169"></a>Synopsis</h1></h2><pre class="synopsis">
@ -42,6 +42,32 @@ void (<a href="libxml-xmlerror.html#xmlGenericErrorFunc">*xmlGenericError
...);
void (<a href="libxml-xmlerror.html#xmlStructuredErrorFunc">*xmlStructuredErrorFunc</a>) (void *userData,
<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> error);
void <a href="libxml-xmlerror.html#xmlSetGenericErrorFunc">xmlSetGenericErrorFunc</a> (void *ctx,
<a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> handler);
void <a href="libxml-xmlerror.html#initGenericErrorDefaultFunc">initGenericErrorDefaultFunc</a> (<a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> *handler);
void <a href="libxml-xmlerror.html#xmlSetStructuredErrorFunc">xmlSetStructuredErrorFunc</a> (void *ctx,
<a href="libxml-xmlerror.html#xmlStructuredErrorFunc">xmlStructuredErrorFunc</a> handler);
void <a href="libxml-xmlerror.html#xmlParserError">xmlParserError</a> (void *ctx,
const char *msg,
...);
void <a href="libxml-xmlerror.html#xmlParserWarning">xmlParserWarning</a> (void *ctx,
const char *msg,
...);
void <a href="libxml-xmlerror.html#xmlParserValidityError">xmlParserValidityError</a> (void *ctx,
const char *msg,
...);
void <a href="libxml-xmlerror.html#xmlParserValidityWarning">xmlParserValidityWarning</a> (void *ctx,
const char *msg,
...);
void <a href="libxml-xmlerror.html#xmlParserPrintFileInfo">xmlParserPrintFileInfo</a> (<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> input);
void <a href="libxml-xmlerror.html#xmlParserPrintFileContext">xmlParserPrintFileContext</a> (<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> input);
<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> <a href="libxml-xmlerror.html#xmlGetLastError">xmlGetLastError</a> (void);
void <a href="libxml-xmlerror.html#xmlResetLastError">xmlResetLastError</a> (void);
<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> <a href="libxml-xmlerror.html#xmlCtxtGetLastError">xmlCtxtGetLastError</a> (void *ctx);
void <a href="libxml-xmlerror.html#xmlCtxtResetLastError">xmlCtxtResetLastError</a> (void *ctx);
void <a href="libxml-xmlerror.html#xmlResetError">xmlResetError</a> (<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> err);
int <a href="libxml-xmlerror.html#xmlCopyError">xmlCopyError</a> (<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> from,
<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> to);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlErrorLevel"></a>enum xmlErrorLevel</h3><pre class="programlisting">typedef enum {
@ -606,4 +632,106 @@ the module handles the new error reporting mechanism.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>userData</tt></i>:</span></td><td> user provided data for the error callback
</td></tr><tr><td><span class="term"><i><tt>error</tt></i>:</span></td><td> the error being raised.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSetGenericErrorFunc"></a>xmlSetGenericErrorFunc ()</h3><pre class="programlisting">void xmlSetGenericErrorFunc (void *ctx,
<a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> handler);</pre><p>
Function to reset the handler and the error context for out of
context error messages.
This simply means that <i><tt>handler</tt></i> will be called for subsequent
error messages while not parsing nor validating. And <i><tt>ctx</tt></i> will
be passed as first argument to <i><tt>handler</tt></i>
One can simply force messages to be emitted to another FILE * than
stderr by setting <i><tt>ctx</tt></i> to this file handle and <i><tt>handler</tt></i> to NULL.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the new error handling context
</td></tr><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td> the new handler function
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="initGenericErrorDefaultFunc"></a>initGenericErrorDefaultFunc ()</h3><pre class="programlisting">void initGenericErrorDefaultFunc (<a href="libxml-xmlerror.html#xmlGenericErrorFunc">xmlGenericErrorFunc</a> *handler);</pre><p>
Set or reset (if NULL) the default handler for generic errors
to the builtin error function.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td> the handler
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSetStructuredErrorFunc"></a>xmlSetStructuredErrorFunc ()</h3><pre class="programlisting">void xmlSetStructuredErrorFunc (void *ctx,
<a href="libxml-xmlerror.html#xmlStructuredErrorFunc">xmlStructuredErrorFunc</a> handler);</pre><p>
Function to reset the handler and the error context for out of
context structured error messages.
This simply means that <i><tt>handler</tt></i> will be called for subsequent
error messages while not parsing nor validating. And <i><tt>ctx</tt></i> will
be passed as first argument to <i><tt>handler</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the new error handling context
</td></tr><tr><td><span class="term"><i><tt>handler</tt></i>:</span></td><td> the new handler function
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserError"></a>xmlParserError ()</h3><pre class="programlisting">void xmlParserError (void *ctx,
const char *msg,
...);</pre><p>
This is an error that the XML (or HTML) parser can generate</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>msg</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserWarning"></a>xmlParserWarning ()</h3><pre class="programlisting">void xmlParserWarning (void *ctx,
const char *msg,
...);</pre><p>
Display and format a warning messages, gives file, line, position and
extra parameters.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an XML parser context
</td></tr><tr><td><span class="term"><i><tt>msg</tt></i>:</span></td><td> the message to display/transmit
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td> extra parameters for the message display
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserValidityError"></a>xmlParserValidityError ()</h3><pre class="programlisting">void xmlParserValidityError (void *ctx,
const char *msg,
...);</pre><p>
Display and format an validity error messages, gives file,
line, position and extra parameters.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an XML parser context
</td></tr><tr><td><span class="term"><i><tt>msg</tt></i>:</span></td><td> the message to display/transmit
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td> extra parameters for the message display
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserValidityWarning"></a>xmlParserValidityWarning ()</h3><pre class="programlisting">void xmlParserValidityWarning (void *ctx,
const char *msg,
...);</pre><p>
Display and format a validity warning messages, gives file, line,
position and extra parameters.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an XML parser context
</td></tr><tr><td><span class="term"><i><tt>msg</tt></i>:</span></td><td> the message to display/transmit
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td> extra parameters for the message display
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserPrintFileInfo"></a>xmlParserPrintFileInfo ()</h3><pre class="programlisting">void xmlParserPrintFileInfo (<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> input);</pre><p>
Displays the associated file and line informations for the current input</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> an xmlParserInputPtr input
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlParserPrintFileContext"></a>xmlParserPrintFileContext ()</h3><pre class="programlisting">void xmlParserPrintFileContext (<a href="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> input);</pre><p>
Displays current context within the input content for error tracking</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> an xmlParserInputPtr input
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGetLastError"></a>xmlGetLastError ()</h3><pre class="programlisting"><a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> xmlGetLastError (void);</pre><p>
Get the last global error registered. This is per thread if compiled
with thread support.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if no error occured or a pointer to the error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlResetLastError"></a>xmlResetLastError ()</h3><pre class="programlisting">void xmlResetLastError (void);</pre><p>
Cleanup the last global error registered. For parsing error
this does not change the well-formedness result.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlCtxtGetLastError"></a>xmlCtxtGetLastError ()</h3><pre class="programlisting"><a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> xmlCtxtGetLastError (void *ctx);</pre><p>
Get the last parsing error registered.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an XML parser context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>NULL if no error occured or a pointer to the error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCtxtResetLastError"></a>xmlCtxtResetLastError ()</h3><pre class="programlisting">void xmlCtxtResetLastError (void *ctx);</pre><p>
Cleanup the last global error registered. For parsing error
this does not change the well-formedness result.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> an XML parser context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlResetError"></a>xmlResetError ()</h3><pre class="programlisting">void xmlResetError (<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> err);</pre><p>
Cleanup the error.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>err</tt></i>:</span></td><td> pointer to the error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlCopyError"></a>xmlCopyError ()</h3><pre class="programlisting">int xmlCopyError (<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> from,
<a href="libxml-xmlerror.html#xmlErrorPtr">xmlErrorPtr</a> to);</pre><p>
Save the original error to the new place.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>from</tt></i>:</span></td><td> a source error
</td></tr><tr><td><span class="term"><i><tt>to</tt></i>:</span></td><td> a target error
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-c14n.html"><b>&lt;&lt; c14n</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlwin32version.html"><b>xmlwin32version &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,13 +28,12 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-globals.html" title="globals"><link rel="next" href="libxml-xinclude.html" title="xinclude"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-globals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xinclude.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlexports"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlexports</h2><p>xmlexports &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2700265"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlunicode.html" title="xmlunicode"><link rel="next" href="libxml-xinclude.html" title="xinclude"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlunicode.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xinclude.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlexports"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlexports</h2><p>xmlexports &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2678317"></a>Synopsis</h1></h2><pre class="synopsis">
#define <a href="libxml-xmlexports.html#XMLPUBFUN-CAPS">XMLPUBFUN</a>
#define <a href="libxml-xmlexports.html#XMLPUBVAR-CAPS">XMLPUBVAR</a>
#define <a href="libxml-xmlexports.html#XMLCALL-CAPS">XMLCALL</a>
#define <a href="libxml-xmlwin32version.html#LIBXML-DLL-IMPORT-CAPS">LIBXML_DLL_IMPORT</a>
</pre></div><div class="refsect1"><h2>Description</h2><p>
@ -44,9 +43,6 @@ Macros which declare an exportable function</p><p>
</p></div><hr><div class="refsect2"><h3><a name="XMLPUBVAR-CAPS"></a>XMLPUBVAR</h3><pre class="programlisting">#define XMLPUBVAR</pre><p>
Macros which declare an exportable variable</p><p>
</p></div><hr><div class="refsect2"><h3><a name="XMLCALL-CAPS"></a>XMLCALL</h3><pre class="programlisting">#define XMLCALL</pre><p>
Macros which declare the called convention for exported functions</p><p>
</p></div><hr><div class="refsect2"><h3><a name="LIBXML-DLL-IMPORT-CAPS"></a>LIBXML_DLL_IMPORT</h3><pre class="programlisting">#define LIBXML_DLL_IMPORT</pre><p>
Used on Windows (MS C compiler only) to declare a variable as
imported from the library. This macro should be empty when compiling
@ -60,4 +56,4 @@ we define the macro IN_LIBXML on the compiler's command line for this
purpose. The third macro, LIBXML_STATIC, must be defined by any client
code which links against libxml statically.</p><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-globals.html"><b>&lt;&lt; globals</b></a></td><td align="right"><a accesskey="n" href="libxml-xinclude.html"><b>xinclude &gt;&gt;</b></a></td></tr></table></body></html>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlunicode.html"><b>&lt;&lt; xmlunicode</b></a></td><td align="right"><a accesskey="n" href="libxml-xinclude.html"><b>xinclude &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlregexp.html" title="xmlregexp"><link rel="next" href="libxml-xmlIO.html" title="xmlIO"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlregexp.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlIO.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlmemory"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlmemory</h2><p>xmlmemory &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2620782"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlregexp.html" title="xmlregexp"><link rel="next" href="libxml-xmlIO.html" title="xmlIO"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlregexp.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlIO.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlmemory"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlmemory</h2><p>xmlmemory &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2645690"></a>Synopsis</h1></h2><pre class="synopsis">
@ -38,6 +38,48 @@ void* (<a href="libxml-xmlmemory.html#xmlMallocFunc">*xmlMallocFunc</a>)
void* (<a href="libxml-xmlmemory.html#xmlReallocFunc">*xmlReallocFunc</a>) (void *mem,
<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size);
char* (<a href="libxml-xmlmemory.html#xmlStrdupFunc">*xmlStrdupFunc</a>) (const char *str);
int <a href="libxml-xmlmemory.html#xmlMemSetup">xmlMemSetup</a> (<a href="libxml-xmlmemory.html#xmlFreeFunc">xmlFreeFunc</a> freeFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> mallocFunc,
<a href="libxml-xmlmemory.html#xmlReallocFunc">xmlReallocFunc</a> reallocFunc,
<a href="libxml-xmlmemory.html#xmlStrdupFunc">xmlStrdupFunc</a> strdupFunc);
int <a href="libxml-xmlmemory.html#xmlMemGet">xmlMemGet</a> (<a href="libxml-xmlmemory.html#xmlFreeFunc">xmlFreeFunc</a> *freeFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> *mallocFunc,
<a href="libxml-xmlmemory.html#xmlReallocFunc">xmlReallocFunc</a> *reallocFunc,
<a href="libxml-xmlmemory.html#xmlStrdupFunc">xmlStrdupFunc</a> *strdupFunc);
int <a href="libxml-xmlmemory.html#xmlGcMemSetup">xmlGcMemSetup</a> (<a href="libxml-xmlmemory.html#xmlFreeFunc">xmlFreeFunc</a> freeFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> mallocFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> mallocAtomicFunc,
<a href="libxml-xmlmemory.html#xmlReallocFunc">xmlReallocFunc</a> reallocFunc,
<a href="libxml-xmlmemory.html#xmlStrdupFunc">xmlStrdupFunc</a> strdupFunc);
int <a href="libxml-xmlmemory.html#xmlGcMemGet">xmlGcMemGet</a> (<a href="libxml-xmlmemory.html#xmlFreeFunc">xmlFreeFunc</a> *freeFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> *mallocFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> *mallocAtomicFunc,
<a href="libxml-xmlmemory.html#xmlReallocFunc">xmlReallocFunc</a> *reallocFunc,
<a href="libxml-xmlmemory.html#xmlStrdupFunc">xmlStrdupFunc</a> *strdupFunc);
int <a href="libxml-xmlmemory.html#xmlInitMemory">xmlInitMemory</a> (void);
int <a href="libxml-xmlmemory.html#xmlMemUsed">xmlMemUsed</a> (void);
void <a href="libxml-xmlmemory.html#xmlMemDisplay">xmlMemDisplay</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *fp);
void <a href="libxml-xmlmemory.html#xmlMemShow">xmlMemShow</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *fp,
int nr);
void <a href="libxml-xmlmemory.html#xmlMemoryDump">xmlMemoryDump</a> (void);
void* <a href="libxml-xmlmemory.html#xmlMemMalloc">xmlMemMalloc</a> (<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size);
void* <a href="libxml-xmlmemory.html#xmlMemRealloc">xmlMemRealloc</a> (void *ptr,
<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size);
void <a href="libxml-xmlmemory.html#xmlMemFree">xmlMemFree</a> (void *ptr);
char* <a href="libxml-xmlmemory.html#xmlMemoryStrdup">xmlMemoryStrdup</a> (const char *str);
void* <a href="libxml-xmlmemory.html#xmlMallocLoc">xmlMallocLoc</a> (<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size,
const char *file,
int line);
void* <a href="libxml-xmlmemory.html#xmlReallocLoc">xmlReallocLoc</a> (void *ptr,
<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size,
const char *file,
int line);
void* <a href="libxml-xmlmemory.html#xmlMallocAtomicLoc">xmlMallocAtomicLoc</a> (<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size,
const char *file,
int line);
char* <a href="libxml-xmlmemory.html#xmlMemStrdupLoc">xmlMemStrdupLoc</a> (const char *str,
const char *file,
int line);
#define <a href="libxml-xmlmemory.html#xmlMalloc">xmlMalloc</a> (size)
#define <a href="libxml-xmlmemory.html#xmlMallocAtomic">xmlMallocAtomic</a> (size)
#define <a href="libxml-xmlmemory.html#xmlRealloc">xmlRealloc</a> (ptr, size)
@ -70,6 +112,143 @@ Signature for an <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() implementation.
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> a zero terminated string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the copy of the string or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemSetup"></a>xmlMemSetup ()</h3><pre class="programlisting">int xmlMemSetup (<a href="libxml-xmlmemory.html#xmlFreeFunc">xmlFreeFunc</a> freeFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> mallocFunc,
<a href="libxml-xmlmemory.html#xmlReallocFunc">xmlReallocFunc</a> reallocFunc,
<a href="libxml-xmlmemory.html#xmlStrdupFunc">xmlStrdupFunc</a> strdupFunc);</pre><p>
Override the default memory access functions with a new set
This has to be called before any other libxml routines !
</p><p>
Should this be blocked if there was already some allocations
done ?</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>freeFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="free">free</GTKDOCLINK>() function to use
</td></tr><tr><td><span class="term"><i><tt>mallocFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() function to use
</td></tr><tr><td><span class="term"><i><tt>reallocFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="realloc">realloc</GTKDOCLINK>() function to use
</td></tr><tr><td><span class="term"><i><tt>strdupFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() function to use
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 on success
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemGet"></a>xmlMemGet ()</h3><pre class="programlisting">int xmlMemGet (<a href="libxml-xmlmemory.html#xmlFreeFunc">xmlFreeFunc</a> *freeFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> *mallocFunc,
<a href="libxml-xmlmemory.html#xmlReallocFunc">xmlReallocFunc</a> *reallocFunc,
<a href="libxml-xmlmemory.html#xmlStrdupFunc">xmlStrdupFunc</a> *strdupFunc);</pre><p>
Provides the memory access functions set currently in use</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>freeFunc</tt></i>:</span></td><td> place to save the <GTKDOCLINK HREF="free">free</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><i><tt>mallocFunc</tt></i>:</span></td><td> place to save the <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><i><tt>reallocFunc</tt></i>:</span></td><td> place to save the <GTKDOCLINK HREF="realloc">realloc</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><i><tt>strdupFunc</tt></i>:</span></td><td> place to save the <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 on success
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGcMemSetup"></a>xmlGcMemSetup ()</h3><pre class="programlisting">int xmlGcMemSetup (<a href="libxml-xmlmemory.html#xmlFreeFunc">xmlFreeFunc</a> freeFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> mallocFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> mallocAtomicFunc,
<a href="libxml-xmlmemory.html#xmlReallocFunc">xmlReallocFunc</a> reallocFunc,
<a href="libxml-xmlmemory.html#xmlStrdupFunc">xmlStrdupFunc</a> strdupFunc);</pre><p>
Override the default memory access functions with a new set
This has to be called before any other libxml routines !
The mallocAtomicFunc is specialized for atomic block
allocations (i.e. of areas useful for garbage collected memory allocators
</p><p>
Should this be blocked if there was already some allocations
done ?</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>freeFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="free">free</GTKDOCLINK>() function to use
</td></tr><tr><td><span class="term"><i><tt>mallocFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() function to use
</td></tr><tr><td><span class="term"><i><tt>mallocAtomicFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() function to use for atomic allocations
</td></tr><tr><td><span class="term"><i><tt>reallocFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="realloc">realloc</GTKDOCLINK>() function to use
</td></tr><tr><td><span class="term"><i><tt>strdupFunc</tt></i>:</span></td><td> the <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() function to use
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 on success
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlGcMemGet"></a>xmlGcMemGet ()</h3><pre class="programlisting">int xmlGcMemGet (<a href="libxml-xmlmemory.html#xmlFreeFunc">xmlFreeFunc</a> *freeFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> *mallocFunc,
<a href="libxml-xmlmemory.html#xmlMallocFunc">xmlMallocFunc</a> *mallocAtomicFunc,
<a href="libxml-xmlmemory.html#xmlReallocFunc">xmlReallocFunc</a> *reallocFunc,
<a href="libxml-xmlmemory.html#xmlStrdupFunc">xmlStrdupFunc</a> *strdupFunc);</pre><p>
Provides the memory access functions set currently in use
The mallocAtomicFunc is specialized for atomic block
allocations (i.e. of areas useful for garbage collected memory allocators</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>freeFunc</tt></i>:</span></td><td> place to save the <GTKDOCLINK HREF="free">free</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><i><tt>mallocFunc</tt></i>:</span></td><td> place to save the <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><i><tt>mallocAtomicFunc</tt></i>:</span></td><td> place to save the atomic <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><i><tt>reallocFunc</tt></i>:</span></td><td> place to save the <GTKDOCLINK HREF="realloc">realloc</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><i><tt>strdupFunc</tt></i>:</span></td><td> place to save the <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() function in use
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 on success
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlInitMemory"></a>xmlInitMemory ()</h3><pre class="programlisting">int xmlInitMemory (void);</pre><p>
Initialize the memory layer.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 on success
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemUsed"></a>xmlMemUsed ()</h3><pre class="programlisting">int xmlMemUsed (void);</pre><p>
Provides the amount of memory currently allocated</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an int representing the amount of memory allocated.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemDisplay"></a>xmlMemDisplay ()</h3><pre class="programlisting">void xmlMemDisplay (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *fp);</pre><p>
show in-extenso the memory blocks allocated</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>fp</tt></i>:</span></td><td> a FILE descriptor used as the output file, if NULL, the result is
written to the file .memorylist
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemShow"></a>xmlMemShow ()</h3><pre class="programlisting">void xmlMemShow (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *fp,
int nr);</pre><p>
show a show display of the memory allocated, and dump
the <i><tt>nr</tt></i> last allocated areas which were not freed</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>fp</tt></i>:</span></td><td> a FILE descriptor used as the output file
</td></tr><tr><td><span class="term"><i><tt>nr</tt></i>:</span></td><td> number of entries to dump
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemoryDump"></a>xmlMemoryDump ()</h3><pre class="programlisting">void xmlMemoryDump (void);</pre><p>
Dump in-extenso the memory blocks allocated to the file .memorylist</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlMemMalloc"></a>xmlMemMalloc ()</h3><pre class="programlisting">void* xmlMemMalloc (<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size);</pre><p>
a <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() equivalent, with logging of the allocation info.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> an int specifying the size in byte to allocate.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemRealloc"></a>xmlMemRealloc ()</h3><pre class="programlisting">void* xmlMemRealloc (void *ptr,
<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size);</pre><p>
a <GTKDOCLINK HREF="realloc">realloc</GTKDOCLINK>() equivalent, with logging of the allocation info.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ptr</tt></i>:</span></td><td> the initial memory block pointer
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> an int specifying the size in byte to allocate.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemFree"></a>xmlMemFree ()</h3><pre class="programlisting">void xmlMemFree (void *ptr);</pre><p>
a <GTKDOCLINK HREF="free">free</GTKDOCLINK>() equivalent, with error checking.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ptr</tt></i>:</span></td><td> the memory block pointer
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemoryStrdup"></a>xmlMemoryStrdup ()</h3><pre class="programlisting">char* xmlMemoryStrdup (const char *str);</pre><p>
a <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() equivalent, with logging of the allocation info.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the initial string pointer
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a pointer to the new string or NULL if allocation error occurred.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMallocLoc"></a>xmlMallocLoc ()</h3><pre class="programlisting">void* xmlMallocLoc (<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size,
const char *file,
int line);</pre><p>
a <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() equivalent, with logging of the allocation info.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> an int specifying the size in byte to allocate.
</td></tr><tr><td><span class="term"><i><tt>file</tt></i>:</span></td><td> the file name or NULL
</td></tr><tr><td><span class="term"><i><tt>line</tt></i>:</span></td><td> the line number
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReallocLoc"></a>xmlReallocLoc ()</h3><pre class="programlisting">void* xmlReallocLoc (void *ptr,
<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size,
const char *file,
int line);</pre><p>
a <GTKDOCLINK HREF="realloc">realloc</GTKDOCLINK>() equivalent, with logging of the allocation info.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ptr</tt></i>:</span></td><td> the initial memory block pointer
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> an int specifying the size in byte to allocate.
</td></tr><tr><td><span class="term"><i><tt>file</tt></i>:</span></td><td> the file name or NULL
</td></tr><tr><td><span class="term"><i><tt>line</tt></i>:</span></td><td> the line number
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMallocAtomicLoc"></a>xmlMallocAtomicLoc ()</h3><pre class="programlisting">void* xmlMallocAtomicLoc (<GTKDOCLINK HREF="size-t">size_t</GTKDOCLINK> size,
const char *file,
int line);</pre><p>
a <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() equivalent, with logging of the allocation info.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> an int specifying the size in byte to allocate.
</td></tr><tr><td><span class="term"><i><tt>file</tt></i>:</span></td><td> the file name or NULL
</td></tr><tr><td><span class="term"><i><tt>line</tt></i>:</span></td><td> the line number
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemStrdupLoc"></a>xmlMemStrdupLoc ()</h3><pre class="programlisting">char* xmlMemStrdupLoc (const char *str,
const char *file,
int line);</pre><p>
a <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() equivalent, with logging of the allocation info.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the initial string pointer
</td></tr><tr><td><span class="term"><i><tt>file</tt></i>:</span></td><td> the file name or NULL
</td></tr><tr><td><span class="term"><i><tt>line</tt></i>:</span></td><td> the line number
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a pointer to the new string or NULL if allocation error occurred.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMalloc"></a>xmlMalloc()</h3><pre class="programlisting">#define xmlMalloc(size)</pre><p>
Wrapper for the <GTKDOCLINK HREF="malloc">malloc</GTKDOCLINK>() function used in the XML library.</p><p>
@ -85,7 +264,7 @@ Wrapper for the <GTKDOCLINK HREF="realloc">realloc</GTKDOCLINK>() function used
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ptr</tt></i>:</span></td><td> pointer to the existing allocated area
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> number of bytes to allocate
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlMemStrdup"></a>xmlMemStrdup()</h3><pre class="programlisting">#define xmlMemStrdup(str)</pre><p>
Wrapper for the <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() function, <GTKDOCLINK HREF="xmlStrdup">xmlStrdup</GTKDOCLINK>() is usually preferred.</p><p>
Wrapper for the <GTKDOCLINK HREF="strdup">strdup</GTKDOCLINK>() function, <a href="libxml-parser.html#xmlStrdup">xmlStrdup</a>() is usually preferred.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> pointer to the existing string
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlregexp.html"><b>&lt;&lt; xmlregexp</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlIO.html"><b>xmlIO &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xinclude.html" title="xinclude"><link rel="next" href="libxml-debugXML.html" title="debugXML"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xinclude.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-debugXML.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlreader"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlreader</h2><p>xmlreader &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2664017"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xinclude.html" title="xinclude"><link rel="next" href="libxml-debugXML.html" title="debugXML"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xinclude.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-debugXML.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlreader"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlreader</h2><p>xmlreader &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2588680"></a>Synopsis</h1></h2><pre class="synopsis">
@ -37,11 +37,147 @@ enum <a href="libxml-xmlreader.html#xmlParserSeverities">xmlParserSeverit
enum <a href="libxml-xmlreader.html#xmlReaderTypes">xmlReaderTypes</a>;
struct <a href="libxml-xmlreader.html#xmlTextReader">xmlTextReader</a>;
typedef <a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a>;
<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> <a href="libxml-xmlreader.html#xmlNewTextReader">xmlNewTextReader</a> (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> input,
const char *URI);
<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> <a href="libxml-xmlreader.html#xmlNewTextReaderFilename">xmlNewTextReaderFilename</a> (const char *URI);
void <a href="libxml-xmlreader.html#xmlFreeTextReader">xmlFreeTextReader</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderRead">xmlTextReaderRead</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderReadInnerXml">xmlTextReaderReadInnerXml</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderReadOuterXml">xmlTextReaderReadOuterXml</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderReadString">xmlTextReaderReadString</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderReadAttributeValue">xmlTextReaderReadAttributeValue</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderAttributeCount">xmlTextReaderAttributeCount</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderDepth">xmlTextReaderDepth</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderHasAttributes">xmlTextReaderHasAttributes</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderHasValue">xmlTextReaderHasValue</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderIsDefault">xmlTextReaderIsDefault</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderIsEmptyElement">xmlTextReaderIsEmptyElement</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderNodeType">xmlTextReaderNodeType</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderQuoteChar">xmlTextReaderQuoteChar</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderReadState">xmlTextReaderReadState</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderConstBaseUri">xmlTextReaderConstBaseUri</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderConstLocalName">xmlTextReaderConstLocalName</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderConstName">xmlTextReaderConstName</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderConstNamespaceUri">xmlTextReaderConstNamespaceUri</a>
(<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderConstPrefix">xmlTextReaderConstPrefix</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderConstXmlLang">xmlTextReaderConstXmlLang</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderConstString">xmlTextReaderConstString</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);
const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderConstValue">xmlTextReaderConstValue</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderBaseUri">xmlTextReaderBaseUri</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderLocalName">xmlTextReaderLocalName</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderName">xmlTextReaderName</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderNamespaceUri">xmlTextReaderNamespaceUri</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderPrefix">xmlTextReaderPrefix</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderXmlLang">xmlTextReaderXmlLang</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderValue">xmlTextReaderValue</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderClose">xmlTextReaderClose</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderGetAttributeNo">xmlTextReaderGetAttributeNo</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int no);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderGetAttribute">xmlTextReaderGetAttribute</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderGetAttributeNs">xmlTextReaderGetAttributeNs</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *localName,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI);
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> <a href="libxml-xmlreader.html#xmlTextReaderGetRemainder">xmlTextReaderGetRemainder</a>
(<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderLookupNamespace">xmlTextReaderLookupNamespace</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);
int <a href="libxml-xmlreader.html#xmlTextReaderMoveToAttributeNo">xmlTextReaderMoveToAttributeNo</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int no);
int <a href="libxml-xmlreader.html#xmlTextReaderMoveToAttribute">xmlTextReaderMoveToAttribute</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
int <a href="libxml-xmlreader.html#xmlTextReaderMoveToAttributeNs">xmlTextReaderMoveToAttributeNs</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *localName,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI);
int <a href="libxml-xmlreader.html#xmlTextReaderMoveToFirstAttribute">xmlTextReaderMoveToFirstAttribute</a>
(<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderMoveToNextAttribute">xmlTextReaderMoveToNextAttribute</a>
(<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderMoveToElement">xmlTextReaderMoveToElement</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderNormalization">xmlTextReaderNormalization</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderSetParserProp">xmlTextReaderSetParserProp</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int prop,
int value);
int <a href="libxml-xmlreader.html#xmlTextReaderGetParserProp">xmlTextReaderGetParserProp</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int prop);
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> <a href="libxml-xmlreader.html#xmlTextReaderCurrentNode">xmlTextReaderCurrentNode</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> <a href="libxml-xmlreader.html#xmlTextReaderPreserve">xmlTextReaderPreserve</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> <a href="libxml-xmlreader.html#xmlTextReaderCurrentDoc">xmlTextReaderCurrentDoc</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> <a href="libxml-xmlreader.html#xmlTextReaderExpand">xmlTextReaderExpand</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderNext">xmlTextReaderNext</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderNextSibling">xmlTextReaderNextSibling</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderIsValid">xmlTextReaderIsValid</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);
int <a href="libxml-xmlreader.html#xmlTextReaderRelaxNGValidate">xmlTextReaderRelaxNGValidate</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const char *rng);
int <a href="libxml-xmlreader.html#xmlTextReaderRelaxNGSetSchema">xmlTextReaderRelaxNGSetSchema</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);
<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> <a href="libxml-xmlreader.html#xmlReaderWalker">xmlReaderWalker</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> <a href="libxml-xmlreader.html#xmlReaderForDoc">xmlReaderForDoc</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *URL,
const char *encoding,
int options);
<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> <a href="libxml-xmlreader.html#xmlReaderForFile">xmlReaderForFile</a> (const char *filename,
const char *encoding,
int options);
<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> <a href="libxml-xmlreader.html#xmlReaderForMemory">xmlReaderForMemory</a> (const char *buffer,
int size,
const char *URL,
const char *encoding,
int options);
<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> <a href="libxml-xmlreader.html#xmlReaderForFd">xmlReaderForFd</a> (int fd,
const char *URL,
const char *encoding,
int options);
<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> <a href="libxml-xmlreader.html#xmlReaderForIO">xmlReaderForIO</a> (<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
const char *URL,
const char *encoding,
int options);
int <a href="libxml-xmlreader.html#xmlReaderNewWalker">xmlReaderNewWalker</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
int <a href="libxml-xmlreader.html#xmlReaderNewDoc">xmlReaderNewDoc</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *URL,
const char *encoding,
int options);
int <a href="libxml-xmlreader.html#xmlReaderNewFile">xmlReaderNewFile</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const char *filename,
const char *encoding,
int options);
int <a href="libxml-xmlreader.html#xmlReaderNewMemory">xmlReaderNewMemory</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const char *buffer,
int size,
const char *URL,
const char *encoding,
int options);
int <a href="libxml-xmlreader.html#xmlReaderNewFd">xmlReaderNewFd</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int fd,
const char *URL,
const char *encoding,
int options);
int <a href="libxml-xmlreader.html#xmlReaderNewIO">xmlReaderNewIO</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
const char *URL,
const char *encoding,
int options);
typedef <a href="libxml-xmlreader.html#xmlTextReaderLocatorPtr">xmlTextReaderLocatorPtr</a>;
void (<a href="libxml-xmlreader.html#xmlTextReaderErrorFunc">*xmlTextReaderErrorFunc</a>) (void *arg,
const char *msg,
<a href="libxml-xmlreader.html#xmlParserSeverities">xmlParserSeverities</a> severity,
<a href="libxml-xmlreader.html#xmlTextReaderLocatorPtr">xmlTextReaderLocatorPtr</a> locator);
int <a href="libxml-xmlreader.html#xmlTextReaderLocatorLineNumber">xmlTextReaderLocatorLineNumber</a> (<a href="libxml-xmlreader.html#xmlTextReaderLocatorPtr">xmlTextReaderLocatorPtr</a> locator);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xmlreader.html#xmlTextReaderLocatorBaseURI">xmlTextReaderLocatorBaseURI</a> (<a href="libxml-xmlreader.html#xmlTextReaderLocatorPtr">xmlTextReaderLocatorPtr</a> locator);
void <a href="libxml-xmlreader.html#xmlTextReaderSetErrorHandler">xmlTextReaderSetErrorHandler</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-xmlreader.html#xmlTextReaderErrorFunc">xmlTextReaderErrorFunc</a> f,
void *arg);
void <a href="libxml-xmlreader.html#xmlTextReaderGetErrorHandler">xmlTextReaderGetErrorHandler</a> (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-xmlreader.html#xmlTextReaderErrorFunc">xmlTextReaderErrorFunc</a> *f,
void **arg);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlParserProperties"></a>enum xmlParserProperties</h3><pre class="programlisting">typedef enum {
@ -87,7 +223,542 @@ void (<a href="libxml-xmlreader.html#xmlTextReaderErrorFunc">*xmlTextRead
</p></div><hr><div class="refsect2"><h3><a name="xmlTextReaderPtr"></a>xmlTextReaderPtr</h3><pre class="programlisting">typedef xmlTextReader *xmlTextReaderPtr;
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlTextReaderLocatorPtr"></a>xmlTextReaderLocatorPtr</h3><pre class="programlisting">typedef void * xmlTextReaderLocatorPtr;
</p></div><hr><div class="refsect2"><h3><a name="xmlNewTextReader"></a>xmlNewTextReader ()</h3><pre class="programlisting"><a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> xmlNewTextReader (<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> input,
const char *URI);</pre><p>
Create an xmlTextReader structure fed with <i><tt>input</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> the xmlParserInputBufferPtr used to read data
</td></tr><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> the URI information for the source if available
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlTextReaderPtr or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNewTextReaderFilename"></a>xmlNewTextReaderFilename ()</h3><pre class="programlisting"><a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> xmlNewTextReaderFilename (const char *URI);</pre><p>
Create an xmlTextReader structure fed with the resource at <i><tt>URI</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URI</tt></i>:</span></td><td> the URI of the resource to process
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlTextReaderPtr or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeTextReader"></a>xmlFreeTextReader ()</h3><pre class="programlisting">void xmlFreeTextReader (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Deallocate all the resources associated to the reader</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderRead"></a>xmlTextReaderRead ()</h3><pre class="programlisting">int xmlTextReaderRead (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Moves the position of the current instance to the next node in
the stream, exposing its properties.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if the node was read successfully, 0 if there is no more
nodes to read, or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderReadInnerXml"></a>xmlTextReaderReadInnerXml ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderReadInnerXml (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Reads the contents of the current node, including child nodes and markup.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a string containing the XML content, or NULL if the current node
is neither an element nor attribute, or has no child nodes. The
string must be deallocated by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderReadOuterXml"></a>xmlTextReaderReadOuterXml ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderReadOuterXml (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Reads the contents of the current node, including child nodes and markup.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a string containing the XML content, or NULL if the current node
is neither an element nor attribute, or has no child nodes. The
string must be deallocated by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderReadString"></a>xmlTextReaderReadString ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderReadString (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Reads the contents of an element or a text node as a string.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a string containing the contents of the Element or Text node,
or NULL if the reader is positioned on any other type of node.
The string must be deallocated by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderReadAttributeValue"></a>xmlTextReaderReadAttributeValue ()</h3><pre class="programlisting">int xmlTextReaderReadAttributeValue (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Parses an attribute value into one or more Text and EntityReference nodes.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 in case of success, 0 if the reader was not positionned on an
ttribute node or all the attribute values have been read, or -1
in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderAttributeCount"></a>xmlTextReaderAttributeCount ()</h3><pre class="programlisting">int xmlTextReaderAttributeCount (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Provides the number of attributes of the current node</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 i no attributes, -1 in case of error or the attribute count
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderDepth"></a>xmlTextReaderDepth ()</h3><pre class="programlisting">int xmlTextReaderDepth (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The depth of the node in the tree.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the depth or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderHasAttributes"></a>xmlTextReaderHasAttributes ()</h3><pre class="programlisting">int xmlTextReaderHasAttributes (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Whether the node has attributes.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true, 0 if false, and -1 in case or error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderHasValue"></a>xmlTextReaderHasValue ()</h3><pre class="programlisting">int xmlTextReaderHasValue (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Whether the node can have a text value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if true, 0 if false, and -1 in case or error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderIsDefault"></a>xmlTextReaderIsDefault ()</h3><pre class="programlisting">int xmlTextReaderIsDefault (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Whether an Attribute node was generated from the default value
defined in the DTD or schema.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if not defaulted, 1 if defaulted, and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderIsEmptyElement"></a>xmlTextReaderIsEmptyElement ()</h3><pre class="programlisting">int xmlTextReaderIsEmptyElement (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Check if the current node is empty</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if empty, 0 if not and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderNodeType"></a>xmlTextReaderNodeType ()</h3><pre class="programlisting">int xmlTextReaderNodeType (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Get the node type of the current node
Reference:
http://dotgnu.org/pnetlib-doc/System/Xml/XmlNodeType.html</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlNodeType of the current node or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderQuoteChar"></a>xmlTextReaderQuoteChar ()</h3><pre class="programlisting">int xmlTextReaderQuoteChar (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The quotation mark character used to enclose the value of an attribute.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>" or ' and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderReadState"></a>xmlTextReaderReadState ()</h3><pre class="programlisting">int xmlTextReaderReadState (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Gets the read state of the reader.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the state value, or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderConstBaseUri"></a>xmlTextReaderConstBaseUri ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderConstBaseUri (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The base URI of the node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the base URI or NULL if not available, the string
will be deallocated with the reader
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderConstLocalName"></a>xmlTextReaderConstLocalName ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderConstLocalName (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The local name of the node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the local name or NULL if not available, the
string will be deallocated with the reader.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderConstName"></a>xmlTextReaderConstName ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderConstName (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The qualified name of the node, equal to Prefix :LocalName.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the local name or NULL if not available, the string is
deallocated with the reader.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderConstNamespaceUri"></a>xmlTextReaderConstNamespaceUri ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderConstNamespaceUri
(<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The URI defining the namespace associated with the node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the namespace URI or NULL if not available, the string
will be deallocated with the reader
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderConstPrefix"></a>xmlTextReaderConstPrefix ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderConstPrefix (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
A shorthand reference to the namespace associated with the node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the prefix or NULL if not available, the string is deallocated
with the reader.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderConstXmlLang"></a>xmlTextReaderConstXmlLang ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderConstXmlLang (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The xml:lang scope within which the node resides.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xml:lang value or NULL if none exists.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderConstString"></a>xmlTextReaderConstString ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderConstString (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);</pre><p>
Get an interned string from the reader, allows for example to
speedup string name comparisons</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the string to intern.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an interned copy of the string or NULL in case of error. The
string will be deallocated with the reader.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderConstValue"></a>xmlTextReaderConstValue ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderConstValue (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Provides the text value of the node if present</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the string or NULL if not available. The result will be
deallocated on the next <GTKDOCLINK HREF="Read">Read</GTKDOCLINK>() operation.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderBaseUri"></a>xmlTextReaderBaseUri ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderBaseUri (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The base URI of the node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the base URI or NULL if not available
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderLocalName"></a>xmlTextReaderLocalName ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderLocalName (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The local name of the node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the local name or NULL if not available
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderName"></a>xmlTextReaderName ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderName (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The qualified name of the node, equal to Prefix :LocalName.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the local name or NULL if not available
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderNamespaceUri"></a>xmlTextReaderNamespaceUri ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderNamespaceUri (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The URI defining the namespace associated with the node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the namespace URI or NULL if not available
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderPrefix"></a>xmlTextReaderPrefix ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderPrefix (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
A shorthand reference to the namespace associated with the node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the prefix or NULL if not available
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderXmlLang"></a>xmlTextReaderXmlLang ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderXmlLang (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The xml:lang scope within which the node resides.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xml:lang value or NULL if none exists.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderValue"></a>xmlTextReaderValue ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderValue (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Provides the text value of the node if present</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the string or NULL if not available. The retsult must be deallocated
with <a href="libxml-globals.html#xmlFree">xmlFree</a>()
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderClose"></a>xmlTextReaderClose ()</h3><pre class="programlisting">int xmlTextReaderClose (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
This method releases any resources allocated by the current instance
changes the state to Closed and close any underlying input.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderGetAttributeNo"></a>xmlTextReaderGetAttributeNo ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderGetAttributeNo (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int no);</pre><p>
Provides the value of the attribute with the specified index relative
to the containing element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>no</tt></i>:</span></td><td> the zero-based index of the attribute relative to the containing element
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a string containing the value of the specified attribute, or NULL
in case of error. The string must be deallocated by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderGetAttribute"></a>xmlTextReaderGetAttribute ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderGetAttribute (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Provides the value of the attribute with the specified qualified name.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the qualified name of the attribute.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a string containing the value of the specified attribute, or NULL
in case of error. The string must be deallocated by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderGetAttributeNs"></a>xmlTextReaderGetAttributeNs ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderGetAttributeNs (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *localName,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI);</pre><p>
Provides the value of the specified attribute</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>localName</tt></i>:</span></td><td> the local name of the attribute.
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> the namespace URI of the attribute.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a string containing the value of the specified attribute, or NULL
in case of error. The string must be deallocated by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderGetRemainder"></a>xmlTextReaderGetRemainder ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> xmlTextReaderGetRemainder
(<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Method to get the remainder of the buffered XML. this method stops the
parser, set its state to End Of File and return the input stream with
what is left that the parser did not use.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlParserInputBufferPtr attached to the XML or NULL
in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderLookupNamespace"></a>xmlTextReaderLookupNamespace ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderLookupNamespace (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix);</pre><p>
Resolves a namespace prefix in the scope of the current element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> the prefix whose namespace URI is to be resolved. To return
the default namespace, specify NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a string containing the namespace URI to which the prefix maps
or NULL in case of error. The string must be deallocated by the caller.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderMoveToAttributeNo"></a>xmlTextReaderMoveToAttributeNo ()</h3><pre class="programlisting">int xmlTextReaderMoveToAttributeNo (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int no);</pre><p>
Moves the position of the current instance to the attribute with
the specified index relative to the containing element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>no</tt></i>:</span></td><td> the zero-based index of the attribute relative to the containing
element.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 in case of success, -1 in case of error, 0 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderMoveToAttribute"></a>xmlTextReaderMoveToAttribute ()</h3><pre class="programlisting">int xmlTextReaderMoveToAttribute (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Moves the position of the current instance to the attribute with
the specified qualified name.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the qualified name of the attribute.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 in case of success, -1 in case of error, 0 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderMoveToAttributeNs"></a>xmlTextReaderMoveToAttributeNs ()</h3><pre class="programlisting">int xmlTextReaderMoveToAttributeNs (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *localName,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI);</pre><p>
Moves the position of the current instance to the attribute with the
specified local name and namespace URI.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>localName</tt></i>:</span></td><td> the local name of the attribute.
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> the namespace URI of the attribute.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 in case of success, -1 in case of error, 0 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderMoveToFirstAttribute"></a>xmlTextReaderMoveToFirstAttribute ()</h3><pre class="programlisting">int xmlTextReaderMoveToFirstAttribute
(<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Moves the position of the current instance to the first attribute
associated with the current node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 in case of success, -1 in case of error, 0 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderMoveToNextAttribute"></a>xmlTextReaderMoveToNextAttribute ()</h3><pre class="programlisting">int xmlTextReaderMoveToNextAttribute
(<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Moves the position of the current instance to the next attribute
associated with the current node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 in case of success, -1 in case of error, 0 if not found
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderMoveToElement"></a>xmlTextReaderMoveToElement ()</h3><pre class="programlisting">int xmlTextReaderMoveToElement (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Moves the position of the current instance to the node that
contains the current Attribute node.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 in case of success, -1 in case of error, 0 if not moved
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderNormalization"></a>xmlTextReaderNormalization ()</h3><pre class="programlisting">int xmlTextReaderNormalization (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
The value indicating whether to normalize white space and attribute values.
Since attribute value and end of line normalizations are a MUST in the XML
specification only the value true is accepted. The broken bahaviour of
accepting out of range character entities like &amp;<GTKDOCLINK HREF="0-CAPS">0</GTKDOCLINK>; is of course not
supported either.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 or -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderSetParserProp"></a>xmlTextReaderSetParserProp ()</h3><pre class="programlisting">int xmlTextReaderSetParserProp (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int prop,
int value);</pre><p>
Change the parser processing behaviour by changing some of its internal
properties. Note that some properties can only be changed before any
read has been done.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>prop</tt></i>:</span></td><td> the xmlParserProperties to set
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> usually 0 or 1 to (de)activate it
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if the call was successful, or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderGetParserProp"></a>xmlTextReaderGetParserProp ()</h3><pre class="programlisting">int xmlTextReaderGetParserProp (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int prop);</pre><p>
Read the parser internal property.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>prop</tt></i>:</span></td><td> the xmlParserProperties to get
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the value, usually 0 or 1, or -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderCurrentNode"></a>xmlTextReaderCurrentNode ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlTextReaderCurrentNode (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Hacking interface allowing to get the xmlNodePtr correponding to the
current node being accessed by the xmlTextReader. This is dangerous
because the underlying node may be destroyed on the next Reads.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlNodePtr or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderPreserve"></a>xmlTextReaderPreserve ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlTextReaderPreserve (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
current node being accessed by the xmlTextReader. This is dangerous
because the underlying node may be destroyed on the next Reads.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlNodePtr or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderCurrentDoc"></a>xmlTextReaderCurrentDoc ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlTextReaderCurrentDoc (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Hacking interface allowing to get the xmlDocPtr correponding to the
current document being accessed by the xmlTextReader. This is dangerous
because the associated node may be destroyed on the next Reads.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlDocPtr or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderExpand"></a>xmlTextReaderExpand ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlTextReaderExpand (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Reads the contents of the current node and the full subtree. It then makes
the subtree available until the next <a href="libxml-xmlreader.html#xmlTextReaderRead">xmlTextReaderRead</a>() call</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a node pointer valid until the next <a href="libxml-xmlreader.html#xmlTextReaderRead">xmlTextReaderRead</a>() call
or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderNext"></a>xmlTextReaderNext ()</h3><pre class="programlisting">int xmlTextReaderNext (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Skip to the node following the current one in document order while
avoiding the subtree if any.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if the node was read successfully, 0 if there is no more
nodes to read, or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderNextSibling"></a>xmlTextReaderNextSibling ()</h3><pre class="programlisting">int xmlTextReaderNextSibling (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderIsValid"></a>xmlTextReaderIsValid ()</h3><pre class="programlisting">int xmlTextReaderIsValid (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader);</pre><p>
Retrieve the validity status from the parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the flag value 1 if valid, 0 if no, and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderRelaxNGValidate"></a>xmlTextReaderRelaxNGValidate ()</h3><pre class="programlisting">int xmlTextReaderRelaxNGValidate (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const char *rng);</pre><p>
Use RelaxNG to validate the document as it is processed.
Activation is only possible before the first <GTKDOCLINK HREF="Read">Read</GTKDOCLINK>().
if <i><tt>rng</tt></i> is NULL, then RelaxNG validation is desactivated.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>rng</tt></i>:</span></td><td> the path to a RelaxNG schema or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case the RelaxNG validation could be (des)activated and
-1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderRelaxNGSetSchema"></a>xmlTextReaderRelaxNGSetSchema ()</h3><pre class="programlisting">int xmlTextReaderRelaxNGSetSchema (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-relaxng.html#xmlRelaxNGPtr">xmlRelaxNGPtr</a> schema);</pre><p>
Use RelaxNG to validate the document as it is processed.
Activation is only possible before the first <GTKDOCLINK HREF="Read">Read</GTKDOCLINK>().
if <i><tt>schema</tt></i> is NULL, then RelaxNG validation is desactivated.
@ The <i><tt>schema</tt></i> should not be freed until the reader is deallocated
or its use has been deactivated.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>schema</tt></i>:</span></td><td> a precompiled RelaxNG schema
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case the RelaxNG validation could be (des)activated and
-1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderWalker"></a>xmlReaderWalker ()</h3><pre class="programlisting"><a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> xmlReaderWalker (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Create an xmltextReader for a preparsed document.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a preparsed document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new reader or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderForDoc"></a>xmlReaderForDoc ()</h3><pre class="programlisting"><a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> xmlReaderForDoc (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *URL,
const char *encoding,
int options);</pre><p>
Create an xmltextReader for an XML in-memory document.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to a zero terminated string
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new reader or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderForFile"></a>xmlReaderForFile ()</h3><pre class="programlisting"><a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> xmlReaderForFile (const char *filename,
const char *encoding,
int options);</pre><p>
parse an XML file from the filesystem or the network.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> a file or URL
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new reader or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderForMemory"></a>xmlReaderForMemory ()</h3><pre class="programlisting"><a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> xmlReaderForMemory (const char *buffer,
int size,
const char *URL,
const char *encoding,
int options);</pre><p>
Create an xmltextReader for an XML in-memory document.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new reader or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderForFd"></a>xmlReaderForFd ()</h3><pre class="programlisting"><a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> xmlReaderForFd (int fd,
const char *URL,
const char *encoding,
int options);</pre><p>
Create an xmltextReader for an XML from a file descriptor.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>fd</tt></i>:</span></td><td> an open file descriptor
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new reader or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderForIO"></a>xmlReaderForIO ()</h3><pre class="programlisting"><a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> xmlReaderForIO (<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
const char *URL,
const char *encoding,
int options);</pre><p>
Create an xmltextReader for an XML document from I/O functions and source.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ioread</tt></i>:</span></td><td> an I/O read function
</td></tr><tr><td><span class="term"><i><tt>ioclose</tt></i>:</span></td><td> an I/O close function
</td></tr><tr><td><span class="term"><i><tt>ioctx</tt></i>:</span></td><td> an I/O handler
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new reader or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderNewWalker"></a>xmlReaderNewWalker ()</h3><pre class="programlisting">int xmlReaderNewWalker (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Setup an xmltextReader to parse a preparsed XML document.
This reuses the existing <i><tt>reader</tt></i> xmlTextReader.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> an XML reader
</td></tr><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a preparsed document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderNewDoc"></a>xmlReaderNewDoc ()</h3><pre class="programlisting">int xmlReaderNewDoc (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *cur,
const char *URL,
const char *encoding,
int options);</pre><p>
Setup an xmltextReader to parse an XML in-memory document.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).
This reuses the existing <i><tt>reader</tt></i> xmlTextReader.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> an XML reader
</td></tr><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> a pointer to a zero terminated string
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderNewFile"></a>xmlReaderNewFile ()</h3><pre class="programlisting">int xmlReaderNewFile (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const char *filename,
const char *encoding,
int options);</pre><p>
parse an XML file from the filesystem or the network.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).
This reuses the existing <i><tt>reader</tt></i> xmlTextReader.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> an XML reader
</td></tr><tr><td><span class="term"><i><tt>filename</tt></i>:</span></td><td> a file or URL
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderNewMemory"></a>xmlReaderNewMemory ()</h3><pre class="programlisting">int xmlReaderNewMemory (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
const char *buffer,
int size,
const char *URL,
const char *encoding,
int options);</pre><p>
Setup an xmltextReader to parse an XML in-memory document.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).
This reuses the existing <i><tt>reader</tt></i> xmlTextReader.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> an XML reader
</td></tr><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderNewFd"></a>xmlReaderNewFd ()</h3><pre class="programlisting">int xmlReaderNewFd (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
int fd,
const char *URL,
const char *encoding,
int options);</pre><p>
Setup an xmltextReader to parse an XML from a file descriptor.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).
This reuses the existing <i><tt>reader</tt></i> xmlTextReader.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> an XML reader
</td></tr><tr><td><span class="term"><i><tt>fd</tt></i>:</span></td><td> an open file descriptor
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlReaderNewIO"></a>xmlReaderNewIO ()</h3><pre class="programlisting">int xmlReaderNewIO (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread,
<a href="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose,
void *ioctx,
const char *URL,
const char *encoding,
int options);</pre><p>
Setup an xmltextReader to parse an XML document from I/O functions
and source.
The parsing flags <i><tt>options</tt></i> are a combination of xmlParserOption(s).
This reuses the existing <i><tt>reader</tt></i> xmlTextReader.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> an XML reader
</td></tr><tr><td><span class="term"><i><tt>ioread</tt></i>:</span></td><td> an I/O read function
</td></tr><tr><td><span class="term"><i><tt>ioclose</tt></i>:</span></td><td> an I/O close function
</td></tr><tr><td><span class="term"><i><tt>ioctx</tt></i>:</span></td><td> an I/O handler
</td></tr><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the base URL to use for the document
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the document encoding, or NULL
</td></tr><tr><td><span class="term"><i><tt>options</tt></i>:</span></td><td> a combination of xmlParserOption(s)
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 in case of success and -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderLocatorPtr"></a>xmlTextReaderLocatorPtr</h3><pre class="programlisting">typedef void * xmlTextReaderLocatorPtr;
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlTextReaderErrorFunc"></a>xmlTextReaderErrorFunc ()</h3><pre class="programlisting">void (*xmlTextReaderErrorFunc) (void *arg,
@ -101,4 +772,32 @@ void (<a href="libxml-xmlreader.html#xmlTextReaderErrorFunc">*xmlTextRead
</td></tr><tr><td><span class="term"><i><tt>locator</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderLocatorLineNumber"></a>xmlTextReaderLocatorLineNumber ()</h3><pre class="programlisting">int xmlTextReaderLocatorLineNumber (<a href="libxml-xmlreader.html#xmlTextReaderLocatorPtr">xmlTextReaderLocatorPtr</a> locator);</pre><p>
Obtain the line number for the given locator.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>locator</tt></i>:</span></td><td> the xmlTextReaderLocatorPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the line number or -1 in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderLocatorBaseURI"></a>xmlTextReaderLocatorBaseURI ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlTextReaderLocatorBaseURI (<a href="libxml-xmlreader.html#xmlTextReaderLocatorPtr">xmlTextReaderLocatorPtr</a> locator);</pre><p>
Obtain the base URI for the given locator.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>locator</tt></i>:</span></td><td> the xmlTextReaderLocatorPtr used
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the base URI or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderSetErrorHandler"></a>xmlTextReaderSetErrorHandler ()</h3><pre class="programlisting">void xmlTextReaderSetErrorHandler (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-xmlreader.html#xmlTextReaderErrorFunc">xmlTextReaderErrorFunc</a> f,
void *arg);</pre><p>
Register a callback function that will be called on error and warnings.
</p><p>
If <i><tt>f</tt></i> is NULL, the default error and warning handlers are restored.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the callback function to call on error and warnings
</td></tr><tr><td><span class="term"><i><tt>arg</tt></i>:</span></td><td> a user argument to pass to the callback function
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextReaderGetErrorHandler"></a>xmlTextReaderGetErrorHandler ()</h3><pre class="programlisting">void xmlTextReaderGetErrorHandler (<a href="libxml-xmlreader.html#xmlTextReaderPtr">xmlTextReaderPtr</a> reader,
<a href="libxml-xmlreader.html#xmlTextReaderErrorFunc">xmlTextReaderErrorFunc</a> *f,
void **arg);</pre><p>
Retrieve the error callback function and user argument.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>reader</tt></i>:</span></td><td> the xmlTextReaderPtr used
</td></tr><tr><td><span class="term"><i><tt>f</tt></i>:</span></td><td> the callback function or NULL is no callback has been registered
</td></tr><tr><td><span class="term"><i><tt>arg</tt></i>:</span></td><td> a user argument
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xinclude.html"><b>&lt;&lt; xinclude</b></a></td><td align="right"><a accesskey="n" href="libxml-debugXML.html"><b>debugXML &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-encoding.html" title="encoding"><link rel="next" href="libxml-xmlmemory.html" title="xmlmemory"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-encoding.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlmemory.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlregexp"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlregexp</h2><p>xmlregexp &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2645489"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-encoding.html" title="encoding"><link rel="next" href="libxml-xmlmemory.html" title="xmlmemory"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-encoding.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlmemory.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlregexp"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlregexp</h2><p>xmlregexp &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2622339"></a>Synopsis</h1></h2><pre class="synopsis">
@ -36,10 +36,28 @@ struct <a href="libxml-xmlregexp.html#xmlRegexp">xmlRegexp</a>;
typedef <a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a>;
struct <a href="libxml-xmlregexp.html#xmlRegExecCtxt">xmlRegExecCtxt</a>;
typedef <a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a>;
<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> <a href="libxml-xmlregexp.html#xmlRegexpCompile">xmlRegexpCompile</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *regexp);
void <a href="libxml-xmlregexp.html#xmlRegFreeRegexp">xmlRegFreeRegexp</a> (<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> regexp);
int <a href="libxml-xmlregexp.html#xmlRegexpExec">xmlRegexpExec</a> (<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> comp,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);
void <a href="libxml-xmlregexp.html#xmlRegexpPrint">xmlRegexpPrint</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> regexp);
int <a href="libxml-xmlregexp.html#xmlRegexpIsDeterminist">xmlRegexpIsDeterminist</a> (<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> comp);
void (<a href="libxml-xmlregexp.html#xmlRegExecCallbacks">*xmlRegExecCallbacks</a>) (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
void *transdata,
void *inputdata);
<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> <a href="libxml-xmlregexp.html#xmlRegNewExecCtxt">xmlRegNewExecCtxt</a> (<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> comp,
<a href="libxml-xmlregexp.html#xmlRegExecCallbacks">xmlRegExecCallbacks</a> callback,
void *data);
void <a href="libxml-xmlregexp.html#xmlRegFreeExecCtxt">xmlRegFreeExecCtxt</a> (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec);
int <a href="libxml-xmlregexp.html#xmlRegExecPushString">xmlRegExecPushString</a> (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
void *data);
int <a href="libxml-xmlregexp.html#xmlRegExecPushString2">xmlRegExecPushString2</a> (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value2,
void *data);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlRegexp"></a>struct xmlRegexp</h3><pre class="programlisting">struct xmlRegexp;</pre><p>
@ -55,7 +73,36 @@ thank the POSIX regex expressions.</p><p>
</pre><p>
A libxml progressive regular expression evaluation context</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlRegExecCallbacks"></a>xmlRegExecCallbacks ()</h3><pre class="programlisting">void (*xmlRegExecCallbacks) (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec,
</p></div><hr><div class="refsect2"><h3><a name="xmlRegexpCompile"></a>xmlRegexpCompile ()</h3><pre class="programlisting"><a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> xmlRegexpCompile (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *regexp);</pre><p>
Parses a regular expression conforming to XML Schemas Part 2 Datatype
Appendix F and build an automata suitable for testing strings against
that regular expression</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>regexp</tt></i>:</span></td><td> a regular expression string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the compiled expression or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegFreeRegexp"></a>xmlRegFreeRegexp ()</h3><pre class="programlisting">void xmlRegFreeRegexp (<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> regexp);</pre><p>
Free a regexp</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>regexp</tt></i>:</span></td><td> the regexp
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegexpExec"></a>xmlRegexpExec ()</h3><pre class="programlisting">int xmlRegexpExec (<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> comp,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value);</pre><p>
Check if the regular expression generate the value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>comp</tt></i>:</span></td><td> the compiled regular expression
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if it matches, 0 if not and a negativa value in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegexpPrint"></a>xmlRegexpPrint ()</h3><pre class="programlisting">void xmlRegexpPrint (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> regexp);</pre><p>
Print the content of the compiled regular expression</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the file for the output debug
</td></tr><tr><td><span class="term"><i><tt>regexp</tt></i>:</span></td><td> the compiled regexp
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegexpIsDeterminist"></a>xmlRegexpIsDeterminist ()</h3><pre class="programlisting">int xmlRegexpIsDeterminist (<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> comp);</pre><p>
Check if the regular expression is determinist</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>comp</tt></i>:</span></td><td> the compiled regular expression
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if it yes, 0 if not and a negativa value in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegExecCallbacks"></a>xmlRegExecCallbacks ()</h3><pre class="programlisting">void (*xmlRegExecCallbacks) (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *token,
void *transdata,
void *inputdata);</pre><p>
@ -66,4 +113,40 @@ A libxml progressive regular expression evaluation context</p><p>
</td></tr><tr><td><span class="term"><i><tt>inputdata</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegNewExecCtxt"></a>xmlRegNewExecCtxt ()</h3><pre class="programlisting"><a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> xmlRegNewExecCtxt (<a href="libxml-xmlregexp.html#xmlRegexpPtr">xmlRegexpPtr</a> comp,
<a href="libxml-xmlregexp.html#xmlRegExecCallbacks">xmlRegExecCallbacks</a> callback,
void *data);</pre><p>
Build a context used for progressive evaluation of a regexp.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>comp</tt></i>:</span></td><td> a precompiled regular expression
</td></tr><tr><td><span class="term"><i><tt>callback</tt></i>:</span></td><td> a callback function used for handling progresses in the
automata matching phase
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> the context data associated to the callback in this context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegFreeExecCtxt"></a>xmlRegFreeExecCtxt ()</h3><pre class="programlisting">void xmlRegFreeExecCtxt (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec);</pre><p>
Free the structures associated to a regular expression evaulation context.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>exec</tt></i>:</span></td><td> a regular expression evaulation context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegExecPushString"></a>xmlRegExecPushString ()</h3><pre class="programlisting">int xmlRegExecPushString (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
void *data);</pre><p>
Push one input token in the execution context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>exec</tt></i>:</span></td><td> a regexp execution context or NULL to indicate the end
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> a string token input
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> data associated to the token to reuse in callbacks
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> 1 if the regexp reached a final state, 0 if non-final, and
a negative value in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlRegExecPushString2"></a>xmlRegExecPushString2 ()</h3><pre class="programlisting">int xmlRegExecPushString2 (<a href="libxml-xmlregexp.html#xmlRegExecCtxtPtr">xmlRegExecCtxtPtr</a> exec,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value2,
void *data);</pre><p>
Push one input token in the execution context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>exec</tt></i>:</span></td><td> a regexp execution context or NULL to indicate the end
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the first string token input
</td></tr><tr><td><span class="term"><i><tt>value2</tt></i>:</span></td><td> the second string token input
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> data associated to the token to reuse in callbacks
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td> 1 if the regexp reached a final state, 0 if non-final, and
a negative value in case of error.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-encoding.html"><b>&lt;&lt; encoding</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlmemory.html"><b>xmlmemory &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlwriter.html" title="xmlwriter"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlwriter.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th></tr></table><div class="refentry"><a name="libxml-xmlschemas"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlschemas</h2><p>xmlschemas &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2695119"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlwriter.html" title="xmlwriter"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlwriter.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th></tr></table><div class="refentry"><a name="libxml-xmlschemas"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlschemas</h2><p>xmlschemas &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2677437"></a>Synopsis</h1></h2><pre class="synopsis">
@ -45,6 +45,35 @@ struct <a href="libxml-xmlschemas.html#xmlSchemaParserCtxt">xmlSchemaParser
typedef <a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a>;
struct <a href="libxml-xmlschemas.html#xmlSchemaValidCtxt">xmlSchemaValidCtxt</a>;
typedef <a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a>;
<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> <a href="libxml-xmlschemas.html#xmlSchemaNewParserCtxt">xmlSchemaNewParserCtxt</a>
(const char *URL);
<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> <a href="libxml-xmlschemas.html#xmlSchemaNewMemParserCtxt">xmlSchemaNewMemParserCtxt</a>
(const char *buffer,
int size);
<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> <a href="libxml-xmlschemas.html#xmlSchemaNewDocParserCtxt">xmlSchemaNewDocParserCtxt</a>
(<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
void <a href="libxml-xmlschemas.html#xmlSchemaFreeParserCtxt">xmlSchemaFreeParserCtxt</a> (<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> ctxt);
void <a href="libxml-xmlschemas.html#xmlSchemaSetParserErrors">xmlSchemaSetParserErrors</a> (<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> ctxt,
<a href="libxml-xmlschemas.html#xmlSchemaValidityErrorFunc">xmlSchemaValidityErrorFunc</a> err,
<a href="libxml-xmlschemas.html#xmlSchemaValidityWarningFunc">xmlSchemaValidityWarningFunc</a> warn,
void *ctx);
<a href="libxml-xmlschemas.html#xmlSchemaPtr">xmlSchemaPtr</a> <a href="libxml-xmlschemas.html#xmlSchemaParse">xmlSchemaParse</a> (<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> ctxt);
void <a href="libxml-xmlschemas.html#xmlSchemaFree">xmlSchemaFree</a> (<a href="libxml-xmlschemas.html#xmlSchemaPtr">xmlSchemaPtr</a> schema);
void <a href="libxml-xmlschemas.html#xmlSchemaDump">xmlSchemaDump</a> (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-xmlschemas.html#xmlSchemaPtr">xmlSchemaPtr</a> schema);
void <a href="libxml-xmlschemas.html#xmlSchemaSetValidErrors">xmlSchemaSetValidErrors</a> (<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> ctxt,
<a href="libxml-xmlschemas.html#xmlSchemaValidityErrorFunc">xmlSchemaValidityErrorFunc</a> err,
<a href="libxml-xmlschemas.html#xmlSchemaValidityWarningFunc">xmlSchemaValidityWarningFunc</a> warn,
void *ctx);
<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> <a href="libxml-xmlschemas.html#xmlSchemaNewValidCtxt">xmlSchemaNewValidCtxt</a> (<a href="libxml-xmlschemas.html#xmlSchemaPtr">xmlSchemaPtr</a> schema);
void <a href="libxml-xmlschemas.html#xmlSchemaFreeValidCtxt">xmlSchemaFreeValidCtxt</a> (<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> ctxt);
int <a href="libxml-xmlschemas.html#xmlSchemaValidateDoc">xmlSchemaValidateDoc</a> (<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> instance);
int <a href="libxml-xmlschemas.html#xmlSchemaValidateStream">xmlSchemaValidateStream</a> (<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> input,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc,
<a href="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax,
void *user_data);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlSchemaValidError"></a>enum xmlSchemaValidError</h3><pre class="programlisting">typedef enum {
@ -132,4 +161,100 @@ A Schemas validation context</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlSchemaValidCtxtPtr"></a>xmlSchemaValidCtxtPtr</h3><pre class="programlisting">typedef xmlSchemaValidCtxt *xmlSchemaValidCtxtPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlwriter.html"><b>&lt;&lt; xmlwriter</b></a></td><td align="right"></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlSchemaNewParserCtxt"></a>xmlSchemaNewParserCtxt ()</h3><pre class="programlisting"><a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> xmlSchemaNewParserCtxt
(const char *URL);</pre><p>
Create an XML Schemas parse context for that file/resource expected
to contain an XML Schemas file.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>URL</tt></i>:</span></td><td> the location of the schema
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the parser context or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaNewMemParserCtxt"></a>xmlSchemaNewMemParserCtxt ()</h3><pre class="programlisting"><a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> xmlSchemaNewMemParserCtxt
(const char *buffer,
int size);</pre><p>
Create an XML Schemas parse context for that memory buffer expected
to contain an XML Schemas file.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buffer</tt></i>:</span></td><td> a pointer to a char array containing the schemas
</td></tr><tr><td><span class="term"><i><tt>size</tt></i>:</span></td><td> the size of the array
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the parser context or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaNewDocParserCtxt"></a>xmlSchemaNewDocParserCtxt ()</h3><pre class="programlisting"><a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> xmlSchemaNewDocParserCtxt
(<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Create an XML Schemas parse context for that document.
NB. The document may be modified during the parsing process.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> a preparsed document tree
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the parser context or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaFreeParserCtxt"></a>xmlSchemaFreeParserCtxt ()</h3><pre class="programlisting">void xmlSchemaFreeParserCtxt (<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> ctxt);</pre><p>
Free the resources associated to the schema parser context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the schema parser context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaSetParserErrors"></a>xmlSchemaSetParserErrors ()</h3><pre class="programlisting">void xmlSchemaSetParserErrors (<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> ctxt,
<a href="libxml-xmlschemas.html#xmlSchemaValidityErrorFunc">xmlSchemaValidityErrorFunc</a> err,
<a href="libxml-xmlschemas.html#xmlSchemaValidityWarningFunc">xmlSchemaValidityWarningFunc</a> warn,
void *ctx);</pre><p>
Set the callback functions used to handle errors for a validation context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a schema validation context
</td></tr><tr><td><span class="term"><i><tt>err</tt></i>:</span></td><td> the error callback
</td></tr><tr><td><span class="term"><i><tt>warn</tt></i>:</span></td><td> the warning callback
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> contextual data for the callbacks
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaParse"></a>xmlSchemaParse ()</h3><pre class="programlisting"><a href="libxml-xmlschemas.html#xmlSchemaPtr">xmlSchemaPtr</a> xmlSchemaParse (<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> ctxt);</pre><p>
parse a schema definition resource and build an internal
XML Shema struture which can be used to validate instances.
*WARNING* this interface is highly subject to change</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a schema validation context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the internal XML Schema structure built from the resource or
NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaFree"></a>xmlSchemaFree ()</h3><pre class="programlisting">void xmlSchemaFree (<a href="libxml-xmlschemas.html#xmlSchemaPtr">xmlSchemaPtr</a> schema);</pre><p>
Deallocate a Schema structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>schema</tt></i>:</span></td><td> a schema structure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaDump"></a>xmlSchemaDump ()</h3><pre class="programlisting">void xmlSchemaDump (<GTKDOCLINK HREF="FILE-CAPS">FILE</GTKDOCLINK> *output,
<a href="libxml-xmlschemas.html#xmlSchemaPtr">xmlSchemaPtr</a> schema);</pre><p>
Dump a Schema structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>output</tt></i>:</span></td><td> the file output
</td></tr><tr><td><span class="term"><i><tt>schema</tt></i>:</span></td><td> a schema structure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaSetValidErrors"></a>xmlSchemaSetValidErrors ()</h3><pre class="programlisting">void xmlSchemaSetValidErrors (<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> ctxt,
<a href="libxml-xmlschemas.html#xmlSchemaValidityErrorFunc">xmlSchemaValidityErrorFunc</a> err,
<a href="libxml-xmlschemas.html#xmlSchemaValidityWarningFunc">xmlSchemaValidityWarningFunc</a> warn,
void *ctx);</pre><p>
Set the error and warning callback informations</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a schema validation context
</td></tr><tr><td><span class="term"><i><tt>err</tt></i>:</span></td><td> the error function
</td></tr><tr><td><span class="term"><i><tt>warn</tt></i>:</span></td><td> the warning function
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the functions context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaNewValidCtxt"></a>xmlSchemaNewValidCtxt ()</h3><pre class="programlisting"><a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> xmlSchemaNewValidCtxt (<a href="libxml-xmlschemas.html#xmlSchemaPtr">xmlSchemaPtr</a> schema);</pre><p>
Create an XML Schemas validation context based on the given schema</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>schema</tt></i>:</span></td><td> a precompiled XML Schemas
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the validation context or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaFreeValidCtxt"></a>xmlSchemaFreeValidCtxt ()</h3><pre class="programlisting">void xmlSchemaFreeValidCtxt (<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> ctxt);</pre><p>
Free the resources associated to the schema validation context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the schema validation context
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaValidateDoc"></a>xmlSchemaValidateDoc ()</h3><pre class="programlisting">int xmlSchemaValidateDoc (<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> instance);</pre><p>
Validate a document tree in memory.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a schema validation context
</td></tr><tr><td><span class="term"><i><tt>instance</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if the document is schemas valid, a positive error code
number otherwise and -1 in case of internal or API error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaValidateStream"></a>xmlSchemaValidateStream ()</h3><pre class="programlisting">int xmlSchemaValidateStream (<a href="libxml-xmlschemas.html#xmlSchemaValidCtxtPtr">xmlSchemaValidCtxtPtr</a> ctxt,
<a href="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> input,
<a href="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc,
<a href="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax,
void *user_data);</pre><p>
Validate a document tree in memory.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> a schema validation context
</td></tr><tr><td><span class="term"><i><tt>input</tt></i>:</span></td><td> the input to use for reading the data
</td></tr><tr><td><span class="term"><i><tt>enc</tt></i>:</span></td><td> an optional encoding information
</td></tr><tr><td><span class="term"><i><tt>sax</tt></i>:</span></td><td> a SAX handler for the resulting events
</td></tr><tr><td><span class="term"><i><tt>user_data</tt></i>:</span></td><td> the context to provide to the SAX handler.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if the document is schemas valid, a positive error code
number otherwise and -1 in case of internal or API error.
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlwriter.html"><b>&lt;&lt; xmlwriter</b></a></td><td align="right"></td></tr></table></body></html>

View File

@ -1,4 +1,4 @@
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xmlschemastypes</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>xmlschemastypes</title><meta name="generator" content="DocBook XSL Stylesheets V1.48"><meta name="generator" content="GTK-Doc V1.1 (XML mode)"><style type="text/css">
.synopsis, .classsynopsis {
background: #eeeeee;
border: solid 1px #aaaaaa;
@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="libxml-lib.html" title="Libxml Library Reference"><link rel="previous" href="libxml-xmlschemas.html" title="xmlschemas"><link rel="next" href="libxml-schemasInternals.html" title="schemasInternals"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlschemas.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></img></a></td><td><a accesskey="u" href="libxml-lib.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></img></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></img></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-schemasInternals.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></img></a></td></tr></table><div class="refentry" lang="en"><a name="libxml-xmlschemastypes"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlschemastypes</h2><p>xmlschemastypes &#8212; </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlautomata.html" title="xmlautomata"><link rel="next" href="libxml-xpointer.html" title="xpointer"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlautomata.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xpointer.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlschemastypes"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlschemastypes</h2><p>xmlschemastypes &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2740571"></a>Synopsis</h1></h2><pre class="synopsis">
@ -56,87 +56,87 @@ int <a href="libxml-xmlschemastypes.html#xmlSchemaCheckFacet">xmlSchemaC
void <a href="libxml-xmlschemastypes.html#xmlSchemaFreeFacet">xmlSchemaFreeFacet</a> (<a href="libxml-schemasInternals.html#xmlSchemaFacetPtr">xmlSchemaFacetPtr</a> facet);
int <a href="libxml-xmlschemastypes.html#xmlSchemaCompareValues">xmlSchemaCompareValues</a> (<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> x,
<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> y);
</pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="xmlSchemaInitTypes"></a>xmlSchemaInitTypes ()</h3><pre class="programlisting">void xmlSchemaInitTypes (void);</pre><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlSchemaInitTypes"></a>xmlSchemaInitTypes ()</h3><pre class="programlisting">void xmlSchemaInitTypes (void);</pre><p>
</p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaCleanupTypes"></a>xmlSchemaCleanupTypes ()</h3><pre class="programlisting">void xmlSchemaCleanupTypes (void);</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlSchemaCleanupTypes"></a>xmlSchemaCleanupTypes ()</h3><pre class="programlisting">void xmlSchemaCleanupTypes (void);</pre><p>
Cleanup the default XML Schemas type library</p><p>
</p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaGetPredefinedType"></a>xmlSchemaGetPredefinedType ()</h3><pre class="programlisting"><a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> xmlSchemaGetPredefinedType (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
</p></div><hr><div class="refsect2"><h3><a name="xmlSchemaGetPredefinedType"></a>xmlSchemaGetPredefinedType ()</h3><pre class="programlisting"><a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> xmlSchemaGetPredefinedType (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ns);</pre><p>
Lookup a type in the default XML Schemas type library</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> the type name
</td></tr><tr><td><span class="term"><i><tt>ns</tt></i> :</span></td><td> the URI of the namespace usually "http://www.w3.org/2001/XMLSchema"
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the type if found, NULL otherwise
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaValidatePredefinedType"></a>xmlSchemaValidatePredefinedType ()</h3><pre class="programlisting">int xmlSchemaValidatePredefinedType (<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> type,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the type name
</td></tr><tr><td><span class="term"><i><tt>ns</tt></i>:</span></td><td> the URI of the namespace usually "http://www.w3.org/2001/XMLSchema"
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the type if found, NULL otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaValidatePredefinedType"></a>xmlSchemaValidatePredefinedType ()</h3><pre class="programlisting">int xmlSchemaValidatePredefinedType (<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> *val);</pre><p>
Check that a value conforms to the lexical space of the predefined type.
if true a value is computed and returned in <i><tt>val</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td> the predefined type
</td></tr><tr><td><span class="term"><i><tt>value</tt></i> :</span></td><td> the value to check
</td></tr><tr><td><span class="term"><i><tt>val</tt></i> :</span></td><td> the return computed value
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>0 if this validates, a positive error code number otherwise
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the predefined type
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the value to check
</td></tr><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> the return computed value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if this validates, a positive error code number otherwise
and -1 in case of internal or API error.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaValPredefTypeNode"></a>xmlSchemaValPredefTypeNode ()</h3><pre class="programlisting">int xmlSchemaValPredefTypeNode (<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> type,
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaValPredefTypeNode"></a>xmlSchemaValPredefTypeNode ()</h3><pre class="programlisting">int xmlSchemaValPredefTypeNode (<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> type,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> *val,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);</pre><p>
Check that a value conforms to the lexical space of the predefined type.
if true a value is computed and returned in <i><tt>val</tt></i>.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td> the predefined type
</td></tr><tr><td><span class="term"><i><tt>value</tt></i> :</span></td><td> the value to check
</td></tr><tr><td><span class="term"><i><tt>val</tt></i> :</span></td><td> the return computed value
</td></tr><tr><td><span class="term"><i><tt>node</tt></i> :</span></td><td> the node containing the value
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>0 if this validates, a positive error code number otherwise
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>type</tt></i>:</span></td><td> the predefined type
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the value to check
</td></tr><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> the return computed value
</td></tr><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> the node containing the value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if this validates, a positive error code number otherwise
and -1 in case of internal or API error.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaValidateFacet"></a>xmlSchemaValidateFacet ()</h3><pre class="programlisting">int xmlSchemaValidateFacet (<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> base,
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaValidateFacet"></a>xmlSchemaValidateFacet ()</h3><pre class="programlisting">int xmlSchemaValidateFacet (<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> base,
<a href="libxml-schemasInternals.html#xmlSchemaFacetPtr">xmlSchemaFacetPtr</a> facet,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *value,
<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> val);</pre><p>
Check a value against a facet condition</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>base</tt></i> :</span></td><td> the base type
</td></tr><tr><td><span class="term"><i><tt>facet</tt></i> :</span></td><td> the facet to check
</td></tr><tr><td><span class="term"><i><tt>value</tt></i> :</span></td><td> the lexical repr of the value to validate
</td></tr><tr><td><span class="term"><i><tt>val</tt></i> :</span></td><td> the precomputed value
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>0 if the element is schemas valid, a positive error code
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>base</tt></i>:</span></td><td> the base type
</td></tr><tr><td><span class="term"><i><tt>facet</tt></i>:</span></td><td> the facet to check
</td></tr><tr><td><span class="term"><i><tt>value</tt></i>:</span></td><td> the lexical repr of the value to validate
</td></tr><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> the precomputed value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if the element is schemas valid, a positive error code
number otherwise and -1 in case of internal or API error.
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaFreeValue"></a>xmlSchemaFreeValue ()</h3><pre class="programlisting">void xmlSchemaFreeValue (<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> val);</pre><p>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaFreeValue"></a>xmlSchemaFreeValue ()</h3><pre class="programlisting">void xmlSchemaFreeValue (<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> val);</pre><p>
Cleanup the default XML Schemas type library</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>val</tt></i> :</span></td><td>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaNewFacet"></a>xmlSchemaNewFacet ()</h3><pre class="programlisting"><a href="libxml-schemasInternals.html#xmlSchemaFacetPtr">xmlSchemaFacetPtr</a> xmlSchemaNewFacet (void);</pre><p>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaNewFacet"></a>xmlSchemaNewFacet ()</h3><pre class="programlisting"><a href="libxml-schemasInternals.html#xmlSchemaFacetPtr">xmlSchemaFacetPtr</a> xmlSchemaNewFacet (void);</pre><p>
Allocate a new Facet structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the newly allocated structure or NULL in case or error
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaCheckFacet"></a>xmlSchemaCheckFacet ()</h3><pre class="programlisting">int xmlSchemaCheckFacet (<a href="libxml-schemasInternals.html#xmlSchemaFacetPtr">xmlSchemaFacetPtr</a> facet,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly allocated structure or NULL in case or error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaCheckFacet"></a>xmlSchemaCheckFacet ()</h3><pre class="programlisting">int xmlSchemaCheckFacet (<a href="libxml-schemasInternals.html#xmlSchemaFacetPtr">xmlSchemaFacetPtr</a> facet,
<a href="libxml-schemasInternals.html#xmlSchemaTypePtr">xmlSchemaTypePtr</a> typeDecl,
<a href="libxml-xmlschemas.html#xmlSchemaParserCtxtPtr">xmlSchemaParserCtxtPtr</a> ctxt,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Checks the default values types, especially for facets</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>facet</tt></i> :</span></td><td> the facet
</td></tr><tr><td><span class="term"><i><tt>typeDecl</tt></i> :</span></td><td> the schema type definition
</td></tr><tr><td><span class="term"><i><tt>ctxt</tt></i> :</span></td><td> the schema parser context or NULL
</td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td> name of the type
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>0 if okay or -1 in cae of error
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaFreeFacet"></a>xmlSchemaFreeFacet ()</h3><pre class="programlisting">void xmlSchemaFreeFacet (<a href="libxml-schemasInternals.html#xmlSchemaFacetPtr">xmlSchemaFacetPtr</a> facet);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>facet</tt></i>:</span></td><td> the facet
</td></tr><tr><td><span class="term"><i><tt>typeDecl</tt></i>:</span></td><td> the schema type definition
</td></tr><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the schema parser context or NULL
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> name of the type
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>0 if okay or -1 in cae of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaFreeFacet"></a>xmlSchemaFreeFacet ()</h3><pre class="programlisting">void xmlSchemaFreeFacet (<a href="libxml-schemasInternals.html#xmlSchemaFacetPtr">xmlSchemaFacetPtr</a> facet);</pre><p>
Deallocate a Schema Facet structure.</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>facet</tt></i> :</span></td><td> a schema facet structure
</td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlSchemaCompareValues"></a>xmlSchemaCompareValues ()</h3><pre class="programlisting">int xmlSchemaCompareValues (<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> x,
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>facet</tt></i>:</span></td><td> a schema facet structure
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlSchemaCompareValues"></a>xmlSchemaCompareValues ()</h3><pre class="programlisting">int xmlSchemaCompareValues (<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> x,
<a href="libxml-schemasInternals.html#xmlSchemaValPtr">xmlSchemaValPtr</a> y);</pre><p>
Compare 2 values</p><p>
</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>x</tt></i> :</span></td><td> a first value
</td></tr><tr><td><span class="term"><i><tt>y</tt></i> :</span></td><td> a second value
</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>-1 if x &lt; y, 0 if x == y, 1 if x &gt; y, 2 if x &lt;&gt; y, and -2 in
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>x</tt></i>:</span></td><td> a first value
</td></tr><tr><td><span class="term"><i><tt>y</tt></i>:</span></td><td> a second value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-1 if x &lt; y, 0 if x == y, 1 if x &gt; y, 2 if x &lt;&gt; y, and -2 in
case of error
</td></tr></tbody></table></div></div></div></div><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlschemas.html"><b>&lt;&lt; xmlschemas</b></a></td><td align="right"><a accesskey="n" href="libxml-schemasInternals.html"><b>schemasInternals &gt;&gt;</b></a></td></tr></table></body></html>
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlautomata.html"><b>&lt;&lt; xmlautomata</b></a></td><td align="right"><a accesskey="n" href="libxml-xpointer.html"><b>xpointer &gt;&gt;</b></a></td></tr></table></body></html>

File diff suppressed because it is too large Load Diff

View File

@ -28,10 +28,11 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xpathInternals.html" title="xpathInternals"><link rel="next" href="libxml-list.html" title="list"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xpathInternals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-list.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlversion"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlversion</h2><p>xmlversion &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2693440"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xpathInternals.html" title="xpathInternals"><link rel="next" href="libxml-list.html" title="list"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xpathInternals.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-list.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlversion"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlversion</h2><p>xmlversion &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2772164"></a>Synopsis</h1></h2><pre class="synopsis">
void <a href="libxml-xmlwin32version.html#xmlCheckVersion">xmlCheckVersion</a> (int version);
#define <a href="libxml-xmlwin32version.html#LIBXML-DOTTED-VERSION-CAPS">LIBXML_DOTTED_VERSION</a>
#define <a href="libxml-xmlwin32version.html#LIBXML-VERSION-CAPS">LIBXML_VERSION</a>
#define <a href="libxml-xmlwin32version.html#LIBXML-VERSION-STRING-CAPS">LIBXML_VERSION_STRING</a>
@ -67,7 +68,14 @@
#define <a href="libxml-xmlwin32version.html#ATTRIBUTE-UNUSED-CAPS">ATTRIBUTE_UNUSED</a>
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="LIBXML-DOTTED-VERSION-CAPS"></a>LIBXML_DOTTED_VERSION</h3><pre class="programlisting">#define LIBXML_DOTTED_VERSION</pre><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlCheckVersion"></a>xmlCheckVersion ()</h3><pre class="programlisting">void xmlCheckVersion (int version);</pre><p>
check the compiled lib version against the include one.
This can warn or immediately kill the application</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>version</tt></i>:</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="LIBXML-DOTTED-VERSION-CAPS"></a>LIBXML_DOTTED_VERSION</h3><pre class="programlisting">#define LIBXML_DOTTED_VERSION</pre><p>
the version string like "1.2.3"</p><p>
</p></div><hr><div class="refsect2"><h3><a name="LIBXML-VERSION-CAPS"></a>LIBXML_VERSION</h3><pre class="programlisting">#define LIBXML_VERSION</pre><p>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlerror.html" title="xmlerror"><link rel="next" href="libxml-DOCBparser.html" title="DOCBparser"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlerror.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-DOCBparser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlwin32version"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlwin32version</h2><p>xmlwin32version &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2631331"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlerror.html" title="xmlerror"><link rel="next" href="libxml-DOCBparser.html" title="DOCBparser"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlerror.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-DOCBparser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlwin32version"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlwin32version</h2><p>xmlwin32version &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2699818"></a>Synopsis</h1></h2><pre class="synopsis">

View File

@ -28,17 +28,257 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-debugXML.html" title="debugXML"><link rel="next" href="libxml-xmlschemas.html" title="xmlschemas"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-debugXML.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-xmlschemas.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlwriter"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlwriter</h2><p>xmlwriter &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2721958"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-debugXML.html" title="debugXML"><link rel="next" href="libxml-xmlschemas.html" title="xmlschemas"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-debugXML.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-xmlschemas.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xmlwriter"></a><div class="titlepage"></div><div class="refnamediv"><h2>xmlwriter</h2><p>xmlwriter &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2771402"></a>Synopsis</h1></h2><pre class="synopsis">
struct <a href="libxml-xmlwriter.html#xmlTextWriter">xmlTextWriter</a>;
typedef <a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a>;
<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> <a href="libxml-xmlwriter.html#xmlNewTextWriter">xmlNewTextWriter</a> (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out);
<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> <a href="libxml-xmlwriter.html#xmlNewTextWriterFilename">xmlNewTextWriterFilename</a> (const char *uri,
int compression);
<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> <a href="libxml-xmlwriter.html#xmlNewTextWriterMemory">xmlNewTextWriterMemory</a> (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
int compression);
void <a href="libxml-xmlwriter.html#xmlFreeTextWriter">xmlFreeTextWriter</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartDocument">xmlTextWriterStartDocument</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *version,
const char *encoding,
const char *standalone);
int <a href="libxml-xmlwriter.html#xmlTextWriterEndDocument">xmlTextWriterEndDocument</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatComment">xmlTextWriterWriteFormatComment</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatComment">xmlTextWriterWriteVFormatComment</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteComment">xmlTextWriterWriteComment</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartElement">xmlTextWriterStartElement</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartElementNS">xmlTextWriterStartElementNS</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI);
int <a href="libxml-xmlwriter.html#xmlTextWriterEndElement">xmlTextWriterEndElement</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterFullEndElement">xmlTextWriterFullEndElement</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatElement">xmlTextWriterWriteFormatElement</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatElement">xmlTextWriterWriteVFormatElement</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteElement">xmlTextWriterWriteElement</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatElementNS">xmlTextWriterWriteFormatElementNS</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatElementNS">xmlTextWriterWriteVFormatElementNS</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteElementNS">xmlTextWriterWriteElementNS</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatRaw">xmlTextWriterWriteFormatRaw</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatRaw">xmlTextWriterWriteVFormatRaw</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteRawLen">xmlTextWriterWriteRawLen</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content,
int len);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteRaw">xmlTextWriterWriteRaw</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatString">xmlTextWriterWriteFormatString</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatString">xmlTextWriterWriteVFormatString</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteString">xmlTextWriterWriteString</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteBase64">xmlTextWriterWriteBase64</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *data,
int start,
int len);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteBinHex">xmlTextWriterWriteBinHex</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *data,
int start,
int len);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartAttribute">xmlTextWriterStartAttribute</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartAttributeNS">xmlTextWriterStartAttributeNS</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI);
int <a href="libxml-xmlwriter.html#xmlTextWriterEndAttribute">xmlTextWriterEndAttribute</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatAttribute">xmlTextWriterWriteFormatAttribute</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatAttribute">xmlTextWriterWriteVFormatAttribute</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteAttribute">xmlTextWriterWriteAttribute</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatAttributeNS">xmlTextWriterWriteFormatAttributeNS</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatAttributeNS">xmlTextWriterWriteVFormatAttributeNS</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteAttributeNS">xmlTextWriterWriteAttributeNS</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartPI">xmlTextWriterStartPI</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target);
int <a href="libxml-xmlwriter.html#xmlTextWriterEndPI">xmlTextWriterEndPI</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatPI">xmlTextWriterWriteFormatPI</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatPI">xmlTextWriterWriteVFormatPI</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWritePI">xmlTextWriterWritePI</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
#define <a href="libxml-xmlwriter.html#xmlTextWriterWriteProcessingInstruction">xmlTextWriterWriteProcessingInstruction</a>
int <a href="libxml-xmlwriter.html#xmlTextWriterStartCDATA">xmlTextWriterStartCDATA</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterEndCDATA">xmlTextWriterEndCDATA</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatCDATA">xmlTextWriterWriteFormatCDATA</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatCDATA">xmlTextWriterWriteVFormatCDATA</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteCDATA">xmlTextWriterWriteCDATA</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartDTD">xmlTextWriterStartDTD</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid);
int <a href="libxml-xmlwriter.html#xmlTextWriterEndDTD">xmlTextWriterEndDTD</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatDTD">xmlTextWriterWriteFormatDTD</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatDTD">xmlTextWriterWriteVFormatDTD</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteDTD">xmlTextWriterWriteDTD</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *subset);
#define <a href="libxml-xmlwriter.html#xmlTextWriterWriteDocType">xmlTextWriterWriteDocType</a>
int <a href="libxml-xmlwriter.html#xmlTextWriterStartDTDElement">xmlTextWriterStartDTDElement</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
#define <a href="libxml-xmlwriter.html#xmlTextWriterEndDTDElement">xmlTextWriterEndDTDElement</a>
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatDTDElement">xmlTextWriterWriteFormatDTDElement</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatDTDElement">xmlTextWriterWriteVFormatDTDElement</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteDTDElement">xmlTextWriterWriteDTDElement</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartDTDAttlist">xmlTextWriterStartDTDAttlist</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
#define <a href="libxml-xmlwriter.html#xmlTextWriterEndDTDAttlist">xmlTextWriterEndDTDAttlist</a>
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatDTDAttlist">xmlTextWriterWriteFormatDTDAttlist</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatDTDAttlist">xmlTextWriterWriteVFormatDTDAttlist</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteDTDAttlist">xmlTextWriterWriteDTDAttlist</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterStartDTDEntity">xmlTextWriterStartDTDEntity</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
#define <a href="libxml-xmlwriter.html#xmlTextWriterEndDTDEntity">xmlTextWriterEndDTDEntity</a>
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteFormatDTDInternalEntity">xmlTextWriterWriteFormatDTDInternalEntity</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteVFormatDTDInternalEntity">xmlTextWriterWriteVFormatDTDInternalEntity</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteDTDInternalEntity">xmlTextWriterWriteDTDInternalEntity</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteDTDExternalEntity">xmlTextWriterWriteDTDExternalEntity</a>
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ndataid);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteDTDEntity">xmlTextWriterWriteDTDEntity</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ndataid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
int <a href="libxml-xmlwriter.html#xmlTextWriterWriteDTDNotation">xmlTextWriterWriteDTDNotation</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid);
int <a href="libxml-xmlwriter.html#xmlTextWriterFlush">xmlTextWriterFlush</a> (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlTextWriter"></a>struct xmlTextWriter</h3><pre class="programlisting">struct xmlTextWriter;</pre><p>
@ -46,19 +286,703 @@ typedef <a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterPtr"></a>xmlTextWriterPtr</h3><pre class="programlisting">typedef xmlTextWriter *xmlTextWriterPtr;
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteProcessingInstruction"></a>xmlTextWriterWriteProcessingInstruction</h3><pre class="programlisting">#define xmlTextWriterWriteProcessingInstruction xmlTextWriterWritePI
</p></div><hr><div class="refsect2"><h3><a name="xmlNewTextWriter"></a>xmlNewTextWriter ()</h3><pre class="programlisting"><a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> xmlNewTextWriter (<a href="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> out);</pre><p>
Create a new xmlNewTextWriter structure using an xmlOutputBufferPtr</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>out</tt></i>:</span></td><td> an xmlOutputBufferPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlTextWriterPtr or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNewTextWriterFilename"></a>xmlNewTextWriterFilename ()</h3><pre class="programlisting"><a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> xmlNewTextWriterFilename (const char *uri,
int compression);</pre><p>
Create a new xmlNewTextWriter structure with <i><tt>uri</tt></i> as output</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>uri</tt></i>:</span></td><td> the URI of the resource for the output
</td></tr><tr><td><span class="term"><i><tt>compression</tt></i>:</span></td><td> compress the output?
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlTextWriterPtr or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlNewTextWriterMemory"></a>xmlNewTextWriterMemory ()</h3><pre class="programlisting"><a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> xmlNewTextWriterMemory (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
int compression);</pre><p>
Create a new xmlNewTextWriter structure with <i><tt>buf</tt></i> as output
TODO: handle compression</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>buf</tt></i>:</span></td><td> xmlBufferPtr
</td></tr><tr><td><span class="term"><i><tt>compression</tt></i>:</span></td><td> compress the output?
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new xmlTextWriterPtr or NULL in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlFreeTextWriter"></a>xmlFreeTextWriter ()</h3><pre class="programlisting">void xmlFreeTextWriter (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
Deallocate all the resources associated to the writer</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartDocument"></a>xmlTextWriterStartDocument ()</h3><pre class="programlisting">int xmlTextWriterStartDocument (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *version,
const char *encoding,
const char *standalone);</pre><p>
Start a new xml document</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>version</tt></i>:</span></td><td> the xml version ("1.0") or NULL for default ("1.0")
</td></tr><tr><td><span class="term"><i><tt>encoding</tt></i>:</span></td><td> the encoding or NULL for default
</td></tr><tr><td><span class="term"><i><tt>standalone</tt></i>:</span></td><td> "yes" or "no" or NULL for default
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndDocument"></a>xmlTextWriterEndDocument ()</h3><pre class="programlisting">int xmlTextWriterEndDocument (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
End an xml document. All open elements are closed</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatComment"></a>xmlTextWriterWriteFormatComment ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatComment (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
...);</pre><p>
Write an xml comment.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatComment"></a>xmlTextWriterWriteVFormatComment ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatComment
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
va_list argptr);</pre><p>
Write an xml comment.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td> pointer to the first member of the variable argument list.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteComment"></a>xmlTextWriterWriteComment ()</h3><pre class="programlisting">int xmlTextWriterWriteComment (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write an xml comment.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> comment string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartElement"></a>xmlTextWriterStartElement ()</h3><pre class="programlisting">int xmlTextWriterStartElement (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Start an xml element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartElementNS"></a>xmlTextWriterStartElementNS ()</h3><pre class="programlisting">int xmlTextWriterStartElementNS (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI);</pre><p>
Start an xml element with namespace support.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> namespace prefix or NULL
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element local name
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> namespace URI or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndElement"></a>xmlTextWriterEndElement ()</h3><pre class="programlisting">int xmlTextWriterEndElement (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
End the current xml element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterFullEndElement"></a>xmlTextWriterFullEndElement ()</h3><pre class="programlisting">int xmlTextWriterFullEndElement (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
End the current xml element. Writes an end tag even if the element is empty</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatElement"></a>xmlTextWriterWriteFormatElement ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatElement (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);</pre><p>
Write a formatted xml element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element name
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatElement"></a>xmlTextWriterWriteVFormatElement ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatElement
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);</pre><p>
Write a formatted xml element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element name
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td> pointer to the first member of the variable argument list.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteElement"></a>xmlTextWriterWriteElement ()</h3><pre class="programlisting">int xmlTextWriterWriteElement (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write an xml element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element name
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> element content
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatElementNS"></a>xmlTextWriterWriteFormatElementNS ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatElementNS
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const char *format,
...);</pre><p>
Write a formatted xml element with namespace support.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> namespace prefix
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element local name
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> namespace URI
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatElementNS"></a>xmlTextWriterWriteVFormatElementNS ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatElementNS
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const char *format,
va_list argptr);</pre><p>
Write a formatted xml element with namespace support.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> namespace prefix
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element local name
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> namespace URI
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td> pointer to the first member of the variable argument list.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteElementNS"></a>xmlTextWriterWriteElementNS ()</h3><pre class="programlisting">int xmlTextWriterWriteElementNS (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write an xml element with namespace support.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> namespace prefix
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element local name
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> namespace URI
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> element content
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatRaw"></a>xmlTextWriterWriteFormatRaw ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatRaw (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
...);</pre><p>
Write a formatted raw xml text.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatRaw"></a>xmlTextWriterWriteVFormatRaw ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatRaw (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
va_list argptr);</pre><p>
Write a formatted raw xml text.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td> pointer to the first member of the variable argument list.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteRawLen"></a>xmlTextWriterWriteRawLen ()</h3><pre class="programlisting">int xmlTextWriterWriteRawLen (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content,
int len);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteRaw"></a>xmlTextWriterWriteRaw ()</h3><pre class="programlisting">int xmlTextWriterWriteRaw (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write a raw xml text.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> text string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatString"></a>xmlTextWriterWriteFormatString ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatString (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
...);</pre><p>
Write a formatted xml text.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatString"></a>xmlTextWriterWriteVFormatString ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatString (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
va_list argptr);</pre><p>
Write a formatted xml text.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td> pointer to the first member of the variable argument list.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteString"></a>xmlTextWriterWriteString ()</h3><pre class="programlisting">int xmlTextWriterWriteString (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write an xml text.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> text string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteBase64"></a>xmlTextWriterWriteBase64 ()</h3><pre class="programlisting">int xmlTextWriterWriteBase64 (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *data,
int start,
int len);</pre><p>
Write an base64 encoded xml text.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> binary data
</td></tr><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the position within the data of the first byte to encode
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the number of bytes to encode
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteBinHex"></a>xmlTextWriterWriteBinHex ()</h3><pre class="programlisting">int xmlTextWriterWriteBinHex (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *data,
int start,
int len);</pre><p>
Write a BinHex encoded xml text.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>data</tt></i>:</span></td><td> binary data
</td></tr><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the position within the data of the first byte to encode
</td></tr><tr><td><span class="term"><i><tt>len</tt></i>:</span></td><td> the number of bytes to encode
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartAttribute"></a>xmlTextWriterStartAttribute ()</h3><pre class="programlisting">int xmlTextWriterStartAttribute (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
Start an xml attribute.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element name
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartAttributeNS"></a>xmlTextWriterStartAttributeNS ()</h3><pre class="programlisting">int xmlTextWriterStartAttributeNS (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI);</pre><p>
Start an xml attribute with namespace support.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> namespace prefix or NULL
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> element local name
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> namespace URI or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndAttribute"></a>xmlTextWriterEndAttribute ()</h3><pre class="programlisting">int xmlTextWriterEndAttribute (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
End the current xml element.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatAttribute"></a>xmlTextWriterWriteFormatAttribute ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatAttribute
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);</pre><p>
Write a formatted xml attribute.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> attribute name
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatAttribute"></a>xmlTextWriterWriteVFormatAttribute ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatAttribute
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);</pre><p>
Write a formatted xml attribute.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> attribute name
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td> pointer to the first member of the variable argument list.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteAttribute"></a>xmlTextWriterWriteAttribute ()</h3><pre class="programlisting">int xmlTextWriterWriteAttribute (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write an xml attribute.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> attribute name
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> attribute content
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatAttributeNS"></a>xmlTextWriterWriteFormatAttributeNS ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatAttributeNS
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const char *format,
...);</pre><p>
Write a formatted xml attribute.with namespace support</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> namespace prefix
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> attribute local name
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> namespace URI
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatAttributeNS"></a>xmlTextWriterWriteVFormatAttributeNS ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatAttributeNS
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const char *format,
va_list argptr);</pre><p>
Write a formatted xml attribute.with namespace support</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> namespace prefix
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> attribute local name
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> namespace URI
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td> pointer to the first member of the variable argument list.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteAttributeNS"></a>xmlTextWriterWriteAttributeNS ()</h3><pre class="programlisting">int xmlTextWriterWriteAttributeNS (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *prefix,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *namespaceURI,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write an xml attribute.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>prefix</tt></i>:</span></td><td> namespace prefix
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> attribute local name
</td></tr><tr><td><span class="term"><i><tt>namespaceURI</tt></i>:</span></td><td> namespace URI
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> attribute content
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartPI"></a>xmlTextWriterStartPI ()</h3><pre class="programlisting">int xmlTextWriterStartPI (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target);</pre><p>
Start an xml PI.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>target</tt></i>:</span></td><td> PI target
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndPI"></a>xmlTextWriterEndPI ()</h3><pre class="programlisting">int xmlTextWriterEndPI (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
End the current xml PI.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatPI"></a>xmlTextWriterWriteFormatPI ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatPI (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target,
const char *format,
...);</pre><p>
Write a formatted PI.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>target</tt></i>:</span></td><td> PI target
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatPI"></a>xmlTextWriterWriteVFormatPI ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatPI (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target,
const char *format,
va_list argptr);</pre><p>
Write a formatted xml PI.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>target</tt></i>:</span></td><td> PI target
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWritePI"></a>xmlTextWriterWritePI ()</h3><pre class="programlisting">int xmlTextWriterWritePI (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *target,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write an xml PI.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>target</tt></i>:</span></td><td> PI target
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> PI content
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteProcessingInstruction"></a>xmlTextWriterWriteProcessingInstruction</h3><pre class="programlisting">#define xmlTextWriterWriteProcessingInstruction xmlTextWriterWritePI
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDocType"></a>xmlTextWriterWriteDocType</h3><pre class="programlisting">#define xmlTextWriterWriteDocType xmlTextWriterWriteDTD
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartCDATA"></a>xmlTextWriterStartCDATA ()</h3><pre class="programlisting">int xmlTextWriterStartCDATA (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
Start an xml CDATA section.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndCDATA"></a>xmlTextWriterEndCDATA ()</h3><pre class="programlisting">int xmlTextWriterEndCDATA (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
End an xml CDATA section.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatCDATA"></a>xmlTextWriterWriteFormatCDATA ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatCDATA (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
...);</pre><p>
Write a formatted xml CDATA.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatCDATA"></a>xmlTextWriterWriteVFormatCDATA ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatCDATA (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const char *format,
va_list argptr);</pre><p>
Write a formatted xml CDATA.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteCDATA"></a>xmlTextWriterWriteCDATA ()</h3><pre class="programlisting">int xmlTextWriterWriteCDATA (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
Write an xml CDATA.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td> CDATA content
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartDTD"></a>xmlTextWriterStartDTD ()</h3><pre class="programlisting">int xmlTextWriterStartDTD (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid);</pre><p>
Start an xml DTD.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the DTD
</td></tr><tr><td><span class="term"><i><tt>pubid</tt></i>:</span></td><td> the public identifier, which is an alternative to the system identifier
</td></tr><tr><td><span class="term"><i><tt>sysid</tt></i>:</span></td><td> the system identifier, which is the URI of the DTD
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndDTD"></a>xmlTextWriterEndDTD ()</h3><pre class="programlisting">int xmlTextWriterEndDTD (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
End an xml DTD.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatDTD"></a>xmlTextWriterWriteFormatDTD ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatDTD (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const char *format,
...);</pre><p>
Write a DTD with a formatted markup declarations part.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the DTD
</td></tr><tr><td><span class="term"><i><tt>pubid</tt></i>:</span></td><td> the public identifier, which is an alternative to the system identifier
</td></tr><tr><td><span class="term"><i><tt>sysid</tt></i>:</span></td><td> the system identifier, which is the URI of the DTD
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatDTD"></a>xmlTextWriterWriteVFormatDTD ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatDTD (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const char *format,
va_list argptr);</pre><p>
Write a DTD with a formatted markup declarations part.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the DTD
</td></tr><tr><td><span class="term"><i><tt>pubid</tt></i>:</span></td><td> the public identifier, which is an alternative to the system identifier
</td></tr><tr><td><span class="term"><i><tt>sysid</tt></i>:</span></td><td> the system identifier, which is the URI of the DTD
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td> format string (see printf)
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDTD"></a>xmlTextWriterWriteDTD ()</h3><pre class="programlisting">int xmlTextWriterWriteDTD (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *subset);</pre><p>
Write a DTD.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td> the name of the DTD
</td></tr><tr><td><span class="term"><i><tt>pubid</tt></i>:</span></td><td> the public identifier, which is an alternative to the system identifier
</td></tr><tr><td><span class="term"><i><tt>sysid</tt></i>:</span></td><td> the system identifier, which is the URI of the DTD
</td></tr><tr><td><span class="term"><i><tt>subset</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDocType"></a>xmlTextWriterWriteDocType</h3><pre class="programlisting">#define xmlTextWriterWriteDocType xmlTextWriterWriteDTD
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndDTDElement"></a>xmlTextWriterEndDTDElement</h3><pre class="programlisting">#define xmlTextWriterEndDTDElement xmlTextWriterEndDTD
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartDTDElement"></a>xmlTextWriterStartDTDElement ()</h3><pre class="programlisting">int xmlTextWriterStartDTDElement (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndDTDElement"></a>xmlTextWriterEndDTDElement</h3><pre class="programlisting">#define xmlTextWriterEndDTDElement xmlTextWriterEndDTD
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndDTDAttlist"></a>xmlTextWriterEndDTDAttlist</h3><pre class="programlisting">#define xmlTextWriterEndDTDAttlist xmlTextWriterEndDTD
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatDTDElement"></a>xmlTextWriterWriteFormatDTDElement ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatDTDElement
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatDTDElement"></a>xmlTextWriterWriteVFormatDTDElement ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatDTDElement
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDTDElement"></a>xmlTextWriterWriteDTDElement ()</h3><pre class="programlisting">int xmlTextWriterWriteDTDElement (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartDTDAttlist"></a>xmlTextWriterStartDTDAttlist ()</h3><pre class="programlisting">int xmlTextWriterStartDTDAttlist (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndDTDAttlist"></a>xmlTextWriterEndDTDAttlist</h3><pre class="programlisting">#define xmlTextWriterEndDTDAttlist xmlTextWriterEndDTD
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndDTDEntity"></a>xmlTextWriterEndDTDEntity</h3><pre class="programlisting">#define xmlTextWriterEndDTDEntity xmlTextWriterEndDTD
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatDTDAttlist"></a>xmlTextWriterWriteFormatDTDAttlist ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatDTDAttlist
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatDTDAttlist"></a>xmlTextWriterWriteVFormatDTDAttlist ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatDTDAttlist
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDTDAttlist"></a>xmlTextWriterWriteDTDAttlist ()</h3><pre class="programlisting">int xmlTextWriterWriteDTDAttlist (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterStartDTDEntity"></a>xmlTextWriterStartDTDEntity ()</h3><pre class="programlisting">int xmlTextWriterStartDTDEntity (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pe</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterEndDTDEntity"></a>xmlTextWriterEndDTDEntity</h3><pre class="programlisting">#define xmlTextWriterEndDTDEntity xmlTextWriterEndDTD
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-debugXML.html"><b>&lt;&lt; debugXML</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlschemas.html"><b>xmlschemas &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteFormatDTDInternalEntity"></a>xmlTextWriterWriteFormatDTDInternalEntity ()</h3><pre class="programlisting">int xmlTextWriterWriteFormatDTDInternalEntity
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
...);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pe</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>...</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteVFormatDTDInternalEntity"></a>xmlTextWriterWriteVFormatDTDInternalEntity ()</h3><pre class="programlisting">int xmlTextWriterWriteVFormatDTDInternalEntity
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const char *format,
va_list argptr);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pe</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>format</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>argptr</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDTDInternalEntity"></a>xmlTextWriterWriteDTDInternalEntity ()</h3><pre class="programlisting">int xmlTextWriterWriteDTDInternalEntity
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pe</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDTDExternalEntity"></a>xmlTextWriterWriteDTDExternalEntity ()</h3><pre class="programlisting">int xmlTextWriterWriteDTDExternalEntity
(<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ndataid);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pe</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pubid</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>sysid</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>ndataid</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDTDEntity"></a>xmlTextWriterWriteDTDEntity ()</h3><pre class="programlisting">int xmlTextWriterWriteDTDEntity (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
int pe,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ndataid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pe</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pubid</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>sysid</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>ndataid</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>content</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterWriteDTDNotation"></a>xmlTextWriterWriteDTDNotation ()</h3><pre class="programlisting">int xmlTextWriterWriteDTDNotation (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *pubid,
const <a href="libxml-tree.html#xmlChar">xmlChar</a> *sysid);</pre><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>name</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>pubid</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><i><tt>sysid</tt></i>:</span></td><td>
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlTextWriterFlush"></a>xmlTextWriterFlush ()</h3><pre class="programlisting">int xmlTextWriterFlush (<a href="libxml-xmlwriter.html#xmlTextWriterPtr">xmlTextWriterPtr</a> writer);</pre><p>
Flush the output buffer.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>writer</tt></i>:</span></td><td> the xmlTextWriterPtr
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the bytes written (may be 0 because of buffering) or -1 in case of error
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-debugXML.html"><b>&lt;&lt; debugXML</b></a></td><td align="right"><a accesskey="n" href="libxml-xmlschemas.html"><b>xmlschemas &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -28,7 +28,7 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlIO.html" title="xmlIO"><link rel="next" href="libxml-chvalid.html" title="chvalid"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlIO.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-chvalid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xpath"></a><div class="titlepage"></div><div class="refnamediv"><h2>xpath</h2><p>xpath &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2591929"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlIO.html" title="xmlIO"><link rel="next" href="libxml-SAX.html" title="SAX"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlIO.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-SAX.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xpath"></a><div class="titlepage"></div><div class="refnamediv"><h2>xpath</h2><p>xpath &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2610919"></a>Synopsis</h1></h2><pre class="synopsis">
@ -63,9 +63,49 @@ void (<a href="libxml-xpath.html#xmlXPathFunction">*xmlXPathFunction</a>)
extern double <a href="libxml-xpath.html#xmlXPathNAN">xmlXPathNAN</a>;
extern double <a href="libxml-xpath.html#xmlXPathPINF">xmlXPathPINF</a>;
extern double <a href="libxml-xpath.html#xmlXPathNINF">xmlXPathNINF</a>;
int <a href="libxml-xpath.html#xmlXPathIsNaN">xmlXPathIsNaN</a> (<GTKDOCLINK HREF="double">double</GTKDOCLINK> val);
int <a href="libxml-xpath.html#xmlXPathIsInf">xmlXPathIsInf</a> (<GTKDOCLINK HREF="double">double</GTKDOCLINK> val);
#define <a href="libxml-xpath.html#xmlXPathNodeSetGetLength">xmlXPathNodeSetGetLength</a> (ns)
#define <a href="libxml-xpath.html#xmlXPathNodeSetItem">xmlXPathNodeSetItem</a> (ns, index)
#define <a href="libxml-xpath.html#xmlXPathNodeSetIsEmpty">xmlXPathNodeSetIsEmpty</a> (ns)
void <a href="libxml-xpath.html#xmlXPathFreeObject">xmlXPathFreeObject</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> obj);
<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> <a href="libxml-xpath.html#xmlXPathNodeSetCreate">xmlXPathNodeSetCreate</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> val);
void <a href="libxml-xpath.html#xmlXPathFreeNodeSetList">xmlXPathFreeNodeSetList</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> obj);
void <a href="libxml-xpath.html#xmlXPathFreeNodeSet">xmlXPathFreeNodeSet</a> (<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> obj);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpath.html#xmlXPathObjectCopy">xmlXPathObjectCopy</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
int <a href="libxml-xpath.html#xmlXPathCmpNodes">xmlXPathCmpNodes</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node1,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);
int <a href="libxml-xpath.html#xmlXPathCastNumberToBoolean">xmlXPathCastNumberToBoolean</a> (<GTKDOCLINK HREF="double">double</GTKDOCLINK> val);
int <a href="libxml-xpath.html#xmlXPathCastStringToBoolean">xmlXPathCastStringToBoolean</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *val);
int <a href="libxml-xpath.html#xmlXPathCastNodeSetToBoolean">xmlXPathCastNodeSetToBoolean</a> (<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> ns);
int <a href="libxml-xpath.html#xmlXPathCastToBoolean">xmlXPathCastToBoolean</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
<GTKDOCLINK HREF="double">double</GTKDOCLINK> <a href="libxml-xpath.html#xmlXPathCastBooleanToNumber">xmlXPathCastBooleanToNumber</a> (int val);
<GTKDOCLINK HREF="double">double</GTKDOCLINK> <a href="libxml-xpath.html#xmlXPathCastStringToNumber">xmlXPathCastStringToNumber</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *val);
<GTKDOCLINK HREF="double">double</GTKDOCLINK> <a href="libxml-xpath.html#xmlXPathCastNodeToNumber">xmlXPathCastNodeToNumber</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);
<GTKDOCLINK HREF="double">double</GTKDOCLINK> <a href="libxml-xpath.html#xmlXPathCastNodeSetToNumber">xmlXPathCastNodeSetToNumber</a> (<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> ns);
<GTKDOCLINK HREF="double">double</GTKDOCLINK> <a href="libxml-xpath.html#xmlXPathCastToNumber">xmlXPathCastToNumber</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xpath.html#xmlXPathCastBooleanToString">xmlXPathCastBooleanToString</a> (int val);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xpath.html#xmlXPathCastNumberToString">xmlXPathCastNumberToString</a> (<GTKDOCLINK HREF="double">double</GTKDOCLINK> val);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xpath.html#xmlXPathCastNodeToString">xmlXPathCastNodeToString</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xpath.html#xmlXPathCastNodeSetToString">xmlXPathCastNodeSetToString</a> (<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> ns);
<a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-xpath.html#xmlXPathCastToString">xmlXPathCastToString</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpath.html#xmlXPathConvertBoolean">xmlXPathConvertBoolean</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpath.html#xmlXPathConvertNumber">xmlXPathConvertNumber</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpath.html#xmlXPathConvertString">xmlXPathConvertString</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
void <a href="libxml-xpath.html#xmlXPathInit">xmlXPathInit</a> (void);
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> <a href="libxml-xpath.html#xmlXPathNewContext">xmlXPathNewContext</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
void <a href="libxml-xpath.html#xmlXPathFreeContext">xmlXPathFreeContext</a> (<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt);
<GTKDOCLINK HREF="long">long</GTKDOCLINK> <a href="libxml-xpath.html#xmlXPathOrderDocElems">xmlXPathOrderDocElems</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpath.html#xmlXPathEval">xmlXPathEval</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str,
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctx);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpath.html#xmlXPathEvalExpression">xmlXPathEvalExpression</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str,
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt);
int <a href="libxml-xpath.html#xmlXPathEvalPredicate">xmlXPathEvalPredicate</a> (<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> res);
<a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> <a href="libxml-xpath.html#xmlXPathCompile">xmlXPathCompile</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpath.html#xmlXPathCompiledEval">xmlXPathCompiledEval</a> (<a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> comp,
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctx);
void <a href="libxml-xpath.html#xmlXPathFreeCompExpr">xmlXPathFreeCompExpr</a> (<a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> comp);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlXPathContext"></a>struct xmlXPathContext</h3><pre class="programlisting">struct xmlXPathContext {
@ -321,7 +361,21 @@ and the result is pushed on the stack.</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlXPathNINF"></a>xmlXPathNINF</h3><pre class="programlisting">extern double xmlXPathNINF;
</pre><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlXPathNodeSetGetLength"></a>xmlXPathNodeSetGetLength()</h3><pre class="programlisting">#define xmlXPathNodeSetGetLength(ns) ((ns) ? (ns)-&gt;nodeNr : 0)
</p></div><hr><div class="refsect2"><h3><a name="xmlXPathIsNaN"></a>xmlXPathIsNaN ()</h3><pre class="programlisting">int xmlXPathIsNaN (<GTKDOCLINK HREF="double">double</GTKDOCLINK> val);</pre><p>
Provides a portable <GTKDOCLINK HREF="isnan">isnan</GTKDOCLINK>() function to detect whether a double
is a NotaNumber. Based on trio code
http://sourceforge.net/projects/ctrio/</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a double value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if the value is a NaN, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathIsInf"></a>xmlXPathIsInf ()</h3><pre class="programlisting">int xmlXPathIsInf (<GTKDOCLINK HREF="double">double</GTKDOCLINK> val);</pre><p>
Provides a portable <GTKDOCLINK HREF="isinf">isinf</GTKDOCLINK>() function to detect whether a double
is a +Infinite or -Infinite. Based on trio code
http://sourceforge.net/projects/ctrio/</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a double value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 vi the value is +Infinite, -1 if -Infinite, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathNodeSetGetLength"></a>xmlXPathNodeSetGetLength()</h3><pre class="programlisting">#define xmlXPathNodeSetGetLength(ns) ((ns) ? (ns)-&gt;nodeNr : 0)
</pre><p>
Implement a functionality similar to the DOM NodeList.length.</p><p>
@ -335,4 +389,195 @@ Implements a functionality similar to the DOM NodeList.<GTKDOCLINK HREF="item">i
Checks whether <i><tt>ns</tt></i> is empty or not.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ns</tt></i>:</span></td><td> a node-set
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlIO.html"><b>&lt;&lt; xmlIO</b></a></td><td align="right"><a accesskey="n" href="libxml-chvalid.html"><b>chvalid &gt;&gt;</b></a></td></tr></table></body></html>
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathFreeObject"></a>xmlXPathFreeObject ()</h3><pre class="programlisting">void xmlXPathFreeObject (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> obj);</pre><p>
Free up an xmlXPathObjectPtr object.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>obj</tt></i>:</span></td><td> the object to free
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathNodeSetCreate"></a>xmlXPathNodeSetCreate ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> xmlXPathNodeSetCreate (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> val);</pre><p>
Create a new xmlNodeSetPtr of type double and of value <i><tt>val</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an initial xmlNodePtr, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathFreeNodeSetList"></a>xmlXPathFreeNodeSetList ()</h3><pre class="programlisting">void xmlXPathFreeNodeSetList (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> obj);</pre><p>
Free up the xmlXPathObjectPtr <i><tt>obj</tt></i> but don't deallocate the objects in
the list contrary to <a href="libxml-xpath.html#xmlXPathFreeObject">xmlXPathFreeObject</a>().</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>obj</tt></i>:</span></td><td> an existing NodeSetList object
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathFreeNodeSet"></a>xmlXPathFreeNodeSet ()</h3><pre class="programlisting">void xmlXPathFreeNodeSet (<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> obj);</pre><p>
Free the NodeSet compound (not the actual nodes !).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>obj</tt></i>:</span></td><td> the xmlNodeSetPtr to free
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathObjectCopy"></a>xmlXPathObjectCopy ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathObjectCopy (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
allocate a new copy of a given object</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> the original object
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCmpNodes"></a>xmlXPathCmpNodes ()</h3><pre class="programlisting">int xmlXPathCmpNodes (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node1,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node2);</pre><p>
Compare two nodes w.r.t document order</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>node1</tt></i>:</span></td><td> the first node
</td></tr><tr><td><span class="term"><i><tt>node2</tt></i>:</span></td><td> the second node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>-2 in case of error 1 if first point &lt; second point, 0 if
that's the same node, -1 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastNumberToBoolean"></a>xmlXPathCastNumberToBoolean ()</h3><pre class="programlisting">int xmlXPathCastNumberToBoolean (<GTKDOCLINK HREF="double">double</GTKDOCLINK> val);</pre><p>
Converts a number to its boolean value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a number
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the boolean value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastStringToBoolean"></a>xmlXPathCastStringToBoolean ()</h3><pre class="programlisting">int xmlXPathCastStringToBoolean (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *val);</pre><p>
Converts a string to its boolean value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the boolean value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastNodeSetToBoolean"></a>xmlXPathCastNodeSetToBoolean ()</h3><pre class="programlisting">int xmlXPathCastNodeSetToBoolean (<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> ns);</pre><p>
Converts a node-set to its boolean value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ns</tt></i>:</span></td><td> a node-set
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the boolean value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastToBoolean"></a>xmlXPathCastToBoolean ()</h3><pre class="programlisting">int xmlXPathCastToBoolean (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
Converts an XPath object to its boolean value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an XPath object
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the boolean value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastBooleanToNumber"></a>xmlXPathCastBooleanToNumber ()</h3><pre class="programlisting"><GTKDOCLINK HREF="double">double</GTKDOCLINK> xmlXPathCastBooleanToNumber (int val);</pre><p>
Converts a boolean to its number value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a boolean
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastStringToNumber"></a>xmlXPathCastStringToNumber ()</h3><pre class="programlisting"><GTKDOCLINK HREF="double">double</GTKDOCLINK> xmlXPathCastStringToNumber (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *val);</pre><p>
Converts a string to its number value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a string
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastNodeToNumber"></a>xmlXPathCastNodeToNumber ()</h3><pre class="programlisting"><GTKDOCLINK HREF="double">double</GTKDOCLINK> xmlXPathCastNodeToNumber (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);</pre><p>
Converts a node to its number value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastNodeSetToNumber"></a>xmlXPathCastNodeSetToNumber ()</h3><pre class="programlisting"><GTKDOCLINK HREF="double">double</GTKDOCLINK> xmlXPathCastNodeSetToNumber (<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> ns);</pre><p>
Converts a node-set to its number value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ns</tt></i>:</span></td><td> a node-set
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastToNumber"></a>xmlXPathCastToNumber ()</h3><pre class="programlisting"><GTKDOCLINK HREF="double">double</GTKDOCLINK> xmlXPathCastToNumber (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
Converts an XPath object to its number value</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an XPath object
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number value
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastBooleanToString"></a>xmlXPathCastBooleanToString ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlXPathCastBooleanToString (int val);</pre><p>
Converts a boolean to its string value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a boolean
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a newly allocated string.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastNumberToString"></a>xmlXPathCastNumberToString ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlXPathCastNumberToString (<GTKDOCLINK HREF="double">double</GTKDOCLINK> val);</pre><p>
Converts a number to its string value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a number
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a newly allocated string.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastNodeToString"></a>xmlXPathCastNodeToString ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlXPathCastNodeToString (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node);</pre><p>
Converts a node to its string value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>node</tt></i>:</span></td><td> a node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a newly allocated string.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastNodeSetToString"></a>xmlXPathCastNodeSetToString ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlXPathCastNodeSetToString (<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> ns);</pre><p>
Converts a node-set to its string value.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ns</tt></i>:</span></td><td> a node-set
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>a newly allocated string.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCastToString"></a>xmlXPathCastToString ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlXPathCastToString (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
Converts an existing object to its <GTKDOCLINK HREF="string">string</GTKDOCLINK>() equivalent</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an XPath object
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the string value of the object, NULL in case of error.
A new string is allocated only if needed (<i><tt>val</tt></i> isn't a
string object).
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathConvertBoolean"></a>xmlXPathConvertBoolean ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathConvertBoolean (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
Converts an existing object to its <GTKDOCLINK HREF="boolean">boolean</GTKDOCLINK>() equivalent</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an XPath object
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new object, the old one is freed (or the operation
is done directly on <i><tt>val</tt></i>)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathConvertNumber"></a>xmlXPathConvertNumber ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathConvertNumber (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
Converts an existing object to its <GTKDOCLINK HREF="number">number</GTKDOCLINK>() equivalent</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an XPath object
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new object, the old one is freed (or the operation
is done directly on <i><tt>val</tt></i>)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathConvertString"></a>xmlXPathConvertString ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathConvertString (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
Converts an existing object to its <GTKDOCLINK HREF="string">string</GTKDOCLINK>() equivalent</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an XPath object
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the new object, the old one is freed (or the operation
is done directly on <i><tt>val</tt></i>)
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathInit"></a>xmlXPathInit ()</h3><pre class="programlisting">void xmlXPathInit (void);</pre><p>
Initialize the XPath environment</p><p>
</p></div><hr><div class="refsect2"><h3><a name="xmlXPathNewContext"></a>xmlXPathNewContext ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> xmlXPathNewContext (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Create a new xmlXPathContext</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the XML document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlXPathContext just allocated. The caller will need to free it.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathFreeContext"></a>xmlXPathFreeContext ()</h3><pre class="programlisting">void xmlXPathFreeContext (<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt);</pre><p>
Free up an xmlXPathContext</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the context to free
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathOrderDocElems"></a>xmlXPathOrderDocElems ()</h3><pre class="programlisting"><GTKDOCLINK HREF="long">long</GTKDOCLINK> xmlXPathOrderDocElems (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc);</pre><p>
Call this routine to speed up XPath computation on static documents.
This stamps all the element nodes with the document order
Like for line information, the order is kept in the element-&gt;content
field, the value stored is actually - the node number (startting at -1)
to be able to differenciate from line numbers.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> an input document
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the number of element found in the document or -1 in case
of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathEval"></a>xmlXPathEval ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathEval (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str,
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctx);</pre><p>
Evaluate the XPath Location Path in the given context.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the XPath expression
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the XPath context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlXPathObjectPtr resulting from the evaluation or NULL.
the caller has to free the object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathEvalExpression"></a>xmlXPathEvalExpression ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathEvalExpression (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str,
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt);</pre><p>
Evaluate the XPath expression in the given context.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the XPath expression
</td></tr><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the XPath context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlXPathObjectPtr resulting from the evaluation or NULL.
the caller has to free the object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathEvalPredicate"></a>xmlXPathEvalPredicate ()</h3><pre class="programlisting">int xmlXPathEvalPredicate (<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctxt,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> res);</pre><p>
Evaluate a predicate result for the current node.
A PredicateExpr is evaluated by evaluating the Expr and converting
the result to a boolean. If the result is a number, the result will
be converted to true if the number is equal to the position of the
context node in the context node list (as returned by the position
function) and will be converted to false otherwise; if the result
is not a number, then the result will be converted as if by a call
to the boolean function.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the XPath context
</td></tr><tr><td><span class="term"><i><tt>res</tt></i>:</span></td><td> the Predicate Expression evaluation result
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>1 if predicate is true, 0 otherwise
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCompile"></a>xmlXPathCompile ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> xmlXPathCompile (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str);</pre><p>
Compile an XPath expression</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the XPath expression
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlXPathCompExprPtr resulting from the compilation or NULL.
the caller has to free the object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathCompiledEval"></a>xmlXPathCompiledEval ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPathCompiledEval (<a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> comp,
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctx);</pre><p>
Evaluate the Precompiled XPath expression in the given context.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>comp</tt></i>:</span></td><td> the compiled XPath expression
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the XPath context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlXPathObjectPtr resulting from the evaluation or NULL.
the caller has to free the object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPathFreeCompExpr"></a>xmlXPathFreeCompExpr ()</h3><pre class="programlisting">void xmlXPathFreeCompExpr (<a href="libxml-xpath.html#xmlXPathCompExprPtr">xmlXPathCompExprPtr</a> comp);</pre><p>
Free up the memory allocated by <i><tt>comp</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>comp</tt></i>:</span></td><td> an XPATH comp
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlIO.html"><b>&lt;&lt; xmlIO</b></a></td><td align="right"><a accesskey="n" href="libxml-SAX.html"><b>SAX &gt;&gt;</b></a></td></tr></table></body></html>

File diff suppressed because it is too large Load Diff

View File

@ -28,12 +28,52 @@
.navigation .title {
font-size: 200%;
}
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual "><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlautomata.html" title="xmlautomata"><link rel="next" href="libxml-hash.html" title="hash"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlautomata.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual </th><td><a accesskey="n" href="libxml-hash.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xpointer"></a><div class="titlepage"></div><div class="refnamediv"><h2>xpointer</h2><p>xpointer &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2659006"></a>Synopsis</h1></h2><pre class="synopsis">
</style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="ch01.html" title="Libxml Programming Notes"><link rel="previous" href="libxml-xmlschemastypes.html" title="xmlschemastypes"><link rel="next" href="libxml-hash.html" title="hash"></head><body text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-xmlschemastypes.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-hash.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry"><a name="libxml-xpointer"></a><div class="titlepage"></div><div class="refnamediv"><h2>xpointer</h2><p>xpointer &#8212; </p></div><div class="refsynopsisdiv"><h2><h1 class="title"><a name="id2750586"></a>Synopsis</h1></h2><pre class="synopsis">
struct <a href="libxml-xpointer.html#xmlLocationSet">xmlLocationSet</a>;
typedef <a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a>;
<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> <a href="libxml-xpointer.html#xmlXPtrLocationSetCreate">xmlXPtrLocationSetCreate</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
void <a href="libxml-xpointer.html#xmlXPtrFreeLocationSet">xmlXPtrFreeLocationSet</a> (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> obj);
<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> <a href="libxml-xpointer.html#xmlXPtrLocationSetMerge">xmlXPtrLocationSetMerge</a> (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> val1,
<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> val2);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewRange">xmlXPtrNewRange</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
int startindex,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> end,
int endindex);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewRangePoints">xmlXPtrNewRangePoints</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> start,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> end);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewRangeNodePoint">xmlXPtrNewRangeNodePoint</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> end);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewRangePointNode">xmlXPtrNewRangePointNode</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> start,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> end);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewRangeNodes">xmlXPtrNewRangeNodes</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> end);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewLocationSetNodes">xmlXPtrNewLocationSetNodes</a>
(<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> end);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewLocationSetNodeSet">xmlXPtrNewLocationSetNodeSet</a>
(<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> set);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewRangeNodeObject">xmlXPtrNewRangeNodeObject</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> end);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewCollapsedRange">xmlXPtrNewCollapsedRange</a> (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start);
void <a href="libxml-xpointer.html#xmlXPtrLocationSetAdd">xmlXPtrLocationSetAdd</a> (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> cur,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrWrapLocationSet">xmlXPtrWrapLocationSet</a> (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> val);
void <a href="libxml-xpointer.html#xmlXPtrLocationSetDel">xmlXPtrLocationSetDel</a> (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> cur,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);
void <a href="libxml-xpointer.html#xmlXPtrLocationSetRemove">xmlXPtrLocationSetRemove</a> (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> cur,
int val);
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> <a href="libxml-xpointer.html#xmlXPtrNewContext">xmlXPtrNewContext</a> (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> here,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> origin);
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> <a href="libxml-xpointer.html#xmlXPtrEval">xmlXPtrEval</a> (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str,
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctx);
void <a href="libxml-xpointer.html#xmlXPtrRangeToFunction">xmlXPtrRangeToFunction</a> (<a href="libxml-xpath.html#xmlXPathParserContextPtr">xmlXPathParserContextPtr</a> ctxt,
int nargs);
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> <a href="libxml-xpointer.html#xmlXPtrBuildNodeList">xmlXPtrBuildNodeList</a> (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> obj);
void <a href="libxml-xpointer.html#xmlXPtrEvalRangePredicate">xmlXPtrEvalRangePredicate</a> (<a href="libxml-xpath.html#xmlXPathParserContextPtr">xmlXPathParserContextPtr</a> ctxt);
</pre></div><div class="refsect1"><h2>Description</h2><p>
</p></div><div class="refsect1"><h2>Details</h2><div class="refsect2"><h3><a name="xmlLocationSet"></a>struct xmlLocationSet</h3><pre class="programlisting">struct xmlLocationSet {
@ -47,4 +87,150 @@ typedef <a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</
</p></div><hr><div class="refsect2"><h3><a name="xmlLocationSetPtr"></a>xmlLocationSetPtr</h3><pre class="programlisting">typedef xmlLocationSet *xmlLocationSetPtr;
</pre><p>
</p></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlautomata.html"><b>&lt;&lt; xmlautomata</b></a></td><td align="right"><a accesskey="n" href="libxml-hash.html"><b>hash &gt;&gt;</b></a></td></tr></table></body></html>
</p></div><hr><div class="refsect2"><h3><a name="xmlXPtrLocationSetCreate"></a>xmlXPtrLocationSetCreate ()</h3><pre class="programlisting"><a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> xmlXPtrLocationSetCreate (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
Create a new xmlLocationSetPtr of type double and of value <i><tt>val</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an initial xmlXPathObjectPtr, or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrFreeLocationSet"></a>xmlXPtrFreeLocationSet ()</h3><pre class="programlisting">void xmlXPtrFreeLocationSet (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> obj);</pre><p>
Free the LocationSet compound (not the actual ranges !).</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>obj</tt></i>:</span></td><td> the xmlLocationSetPtr to free
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrLocationSetMerge"></a>xmlXPtrLocationSetMerge ()</h3><pre class="programlisting"><a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> xmlXPtrLocationSetMerge (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> val1,
<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> val2);</pre><p>
Merges two rangesets, all ranges from <i><tt>val2</tt></i> are added to <i><tt>val1</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val1</tt></i>:</span></td><td> the first LocationSet
</td></tr><tr><td><span class="term"><i><tt>val2</tt></i>:</span></td><td> the second LocationSet
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>val1 once extended or NULL in case of error.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewRange"></a>xmlXPtrNewRange ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewRange (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
int startindex,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> end,
int endindex);</pre><p>
Create a new xmlXPathObjectPtr of type range</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the starting node
</td></tr><tr><td><span class="term"><i><tt>startindex</tt></i>:</span></td><td> the start index
</td></tr><tr><td><span class="term"><i><tt>end</tt></i>:</span></td><td> the ending point
</td></tr><tr><td><span class="term"><i><tt>endindex</tt></i>:</span></td><td> the ending index
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewRangePoints"></a>xmlXPtrNewRangePoints ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewRangePoints (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> start,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> end);</pre><p>
Create a new xmlXPathObjectPtr of type range using 2 Points</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the starting point
</td></tr><tr><td><span class="term"><i><tt>end</tt></i>:</span></td><td> the ending point
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewRangeNodePoint"></a>xmlXPtrNewRangeNodePoint ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewRangeNodePoint (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> end);</pre><p>
Create a new xmlXPathObjectPtr of type range from a node to a point</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the starting node
</td></tr><tr><td><span class="term"><i><tt>end</tt></i>:</span></td><td> the ending point
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewRangePointNode"></a>xmlXPtrNewRangePointNode ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewRangePointNode (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> start,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> end);</pre><p>
Create a new xmlXPathObjectPtr of type range from a point to a node</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the starting point
</td></tr><tr><td><span class="term"><i><tt>end</tt></i>:</span></td><td> the ending node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewRangeNodes"></a>xmlXPtrNewRangeNodes ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewRangeNodes (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> end);</pre><p>
Create a new xmlXPathObjectPtr of type range using 2 nodes</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the starting node
</td></tr><tr><td><span class="term"><i><tt>end</tt></i>:</span></td><td> the ending node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewLocationSetNodes"></a>xmlXPtrNewLocationSetNodes ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewLocationSetNodes
(<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> end);</pre><p>
Create a new xmlXPathObjectPtr of type LocationSet and initialize
it with the single range made of the two nodes <i><tt>start</tt></i> and <i><tt>end</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the start NodePtr value
</td></tr><tr><td><span class="term"><i><tt>end</tt></i>:</span></td><td> the end NodePtr value or NULL
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewLocationSetNodeSet"></a>xmlXPtrNewLocationSetNodeSet ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewLocationSetNodeSet
(<a href="libxml-xpath.html#xmlNodeSetPtr">xmlNodeSetPtr</a> set);</pre><p>
Create a new xmlXPathObjectPtr of type LocationSet and initialize
it with all the nodes from <i><tt>set</tt></i></p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>set</tt></i>:</span></td><td> a node set
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewRangeNodeObject"></a>xmlXPtrNewRangeNodeObject ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewRangeNodeObject (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> end);</pre><p>
Create a new xmlXPathObjectPtr of type range from a not to an object</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the starting node
</td></tr><tr><td><span class="term"><i><tt>end</tt></i>:</span></td><td> the ending object
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewCollapsedRange"></a>xmlXPtrNewCollapsedRange ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrNewCollapsedRange (<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> start);</pre><p>
Create a new xmlXPathObjectPtr of type range using a single nodes</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>start</tt></i>:</span></td><td> the starting and ending node
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrLocationSetAdd"></a>xmlXPtrLocationSetAdd ()</h3><pre class="programlisting">void xmlXPtrLocationSetAdd (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> cur,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
add a new xmlXPathObjectPtr to an existing LocationSet
If the location already exist in the set <i><tt>val</tt></i> is freed.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the initial range set
</td></tr><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> a new xmlXPathObjectPtr
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrWrapLocationSet"></a>xmlXPtrWrapLocationSet ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrWrapLocationSet (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> val);</pre><p>
Wrap the LocationSet <i><tt>val</tt></i> in a new xmlXPathObjectPtr</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> the LocationSet value
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the newly created object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrLocationSetDel"></a>xmlXPtrLocationSetDel ()</h3><pre class="programlisting">void xmlXPtrLocationSetDel (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> cur,
<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> val);</pre><p>
Removes an xmlXPathObjectPtr from an existing LocationSet</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the initial range set
</td></tr><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> an xmlXPathObjectPtr
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrLocationSetRemove"></a>xmlXPtrLocationSetRemove ()</h3><pre class="programlisting">void xmlXPtrLocationSetRemove (<a href="libxml-xpointer.html#xmlLocationSetPtr">xmlLocationSetPtr</a> cur,
int val);</pre><p>
Removes an entry from an existing LocationSet list.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>cur</tt></i>:</span></td><td> the initial range set
</td></tr><tr><td><span class="term"><i><tt>val</tt></i>:</span></td><td> the index to remove
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrNewContext"></a>xmlXPtrNewContext ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> xmlXPtrNewContext (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> here,
<a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> origin);</pre><p>
Create a new XPointer context</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>doc</tt></i>:</span></td><td> the XML document
</td></tr><tr><td><span class="term"><i><tt>here</tt></i>:</span></td><td> the node that directly contains the XPointer being evaluated or NULL
</td></tr><tr><td><span class="term"><i><tt>origin</tt></i>:</span></td><td> the element from which a user or program initiated traversal of
the link, or NULL.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlXPathContext just allocated.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrEval"></a>xmlXPtrEval ()</h3><pre class="programlisting"><a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> xmlXPtrEval (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *str,
<a href="libxml-xpath.html#xmlXPathContextPtr">xmlXPathContextPtr</a> ctx);</pre><p>
Evaluate the XPath Location Path in the given context.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>str</tt></i>:</span></td><td> the XPointer expression
</td></tr><tr><td><span class="term"><i><tt>ctx</tt></i>:</span></td><td> the XPointer context
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>the xmlXPathObjectPtr resulting from the evaluation or NULL.
the caller has to free the object.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrRangeToFunction"></a>xmlXPtrRangeToFunction ()</h3><pre class="programlisting">void xmlXPtrRangeToFunction (<a href="libxml-xpath.html#xmlXPathParserContextPtr">xmlXPathParserContextPtr</a> ctxt,
int nargs);</pre><p>
Implement the range-<GTKDOCLINK HREF="to">to</GTKDOCLINK>() XPointer function</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the XPointer Parser context
</td></tr><tr><td><span class="term"><i><tt>nargs</tt></i>:</span></td><td> the number of args
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrBuildNodeList"></a>xmlXPtrBuildNodeList ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlXPtrBuildNodeList (<a href="libxml-xpath.html#xmlXPathObjectPtr">xmlXPathObjectPtr</a> obj);</pre><p>
Build a node list tree copy of the XPointer result.
This will drop Attributes and Namespace declarations.</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>obj</tt></i>:</span></td><td> the XPointer result from the evaluation.
</td></tr><tr><td><span class="term"><span class="emphasis"><i>Returns</i></span> :</span></td><td>an xmlNodePtr list or NULL.
the caller has to free the node tree.
</td></tr></tbody></table></div></div><hr><div class="refsect2"><h3><a name="xmlXPtrEvalRangePredicate"></a>xmlXPtrEvalRangePredicate ()</h3><pre class="programlisting">void xmlXPtrEvalRangePredicate (<a href="libxml-xpath.html#xmlXPathParserContextPtr">xmlXPathParserContextPtr</a> ctxt);</pre><p>
[8] Predicate ::= '[' PredicateExpr ']'
[9] PredicateExpr ::= Expr
</p><p>
Evaluate a predicate as in <a href="libxml-xpath.html#xmlXPathEvalPredicate">xmlXPathEvalPredicate</a>() but for
a Location Set instead of a node set</p><p>
</p><div class="variablelist"><table border="0"><col align="left"><tbody><tr><td><span class="term"><i><tt>ctxt</tt></i>:</span></td><td> the XPointer Parser context
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-xmlschemastypes.html"><b>&lt;&lt; xmlschemastypes</b></a></td><td align="right"><a accesskey="n" href="libxml-hash.html"><b>hash &gt;&gt;</b></a></td></tr></table></body></html>

View File

@ -30,7 +30,7 @@
extern "C" {
#endif
/**
/*
* xmlCharEncoding:
*
* Predefined values for some standard encodings.

View File

@ -175,7 +175,7 @@ struct _xmlSchemaType {
xmlSchemaFacetPtr facets;
};
/**
/*
* xmlSchemaElement:
* An element definition.
*

View File

@ -53,7 +53,7 @@ typedef void (*xmlValidityWarningFunc) (void *ctx,
const char *msg,
...);
/**
/*
* xmlValidCtxt:
* An xmlValidCtxt is used for error reporting when validating.
*/

View File

@ -63,7 +63,7 @@ typedef enum {
*/
typedef void (*xlinkNodeDetectFunc) (void *ctx, xmlNodePtr node);
/**
/*
* The link detection module interact with the upper layers using
* a set of callback registered at parsing time.
*/

View File

@ -223,7 +223,7 @@ extern void xmlCheckVersion(int version);
#define ATTRIBUTE_UNUSED
#endif
/**
/*
* #pragma comment(lib, "iconv.lib")
*
* pragma understood my MS compiler which enables a conditional link with

View File

@ -232,7 +232,7 @@ extern void xmlCheckVersion(int version);
#define ATTRIBUTE_UNUSED
#endif
/**
/*
* #pragma comment(lib, "iconv.lib")
*
* pragma understood my MS compiler which enables a conditional link with

View File

@ -23,7 +23,7 @@ extern "C" {
* *
************************************************************************/
/**
/*
* Many of these macros may later turn into functions. They
* shouldn't be used in #ifdef's preprocessor instructions.
*/

View File

@ -34,12 +34,13 @@ static int n_failures_this_failure = 0;
static int n_blocks_outstanding = 0;
/**
* set_fail_alloc_counter:
* @until_next_fail: number of successful allocs before one fails
*
* Sets the number of allocations until we simulate a failed
* allocation. If set to 0, the next allocation to run
* fails; if set to 1, one succeeds then the next fails; etc.
* Set to _TEST_INT_MAX to not fail anything.
*
* @param until_next_fail number of successful allocs before one fails
*/
static void
set_fail_alloc_counter (int until_next_fail)
@ -48,10 +49,10 @@ set_fail_alloc_counter (int until_next_fail)
}
/**
* Gets the number of successful allocs until we'll simulate
* a failed alloc.
* get_fail_alloc_counter:
*
* @returns current counter value
* Returns the number of successful allocs until we'll simulate
* a failed alloc.
*/
static int
get_fail_alloc_counter (void)
@ -60,10 +61,12 @@ get_fail_alloc_counter (void)
}
/**
* set_fail_alloc_failures:
* @failures_per_failure: number to fail
*
* Sets how many mallocs to fail when the fail alloc counter reaches
* 0.
*
* @param number to fail
*/
static void
set_fail_alloc_failures (int failures_per_failure)
@ -72,12 +75,14 @@ set_fail_alloc_failures (int failures_per_failure)
}
/**
* decrement_fail_alloc_counter:
*
* Called when about to alloc some memory; if
* it returns #TRUE, then the allocation should
* fail. If it returns #FALSE, then the allocation
* should not fail.
*
* @returns #TRUE if this alloc should fail
* returns #TRUE if this alloc should fail
*/
static int
decrement_fail_alloc_counter (void)
@ -102,9 +107,11 @@ decrement_fail_alloc_counter (void)
}
/**
* test_get_malloc_blocks_outstanding:
*
* Get the number of outstanding malloc()'d blocks.
*
* @returns number of blocks
* Returns number of blocks
*/
int
test_get_malloc_blocks_outstanding (void)
@ -216,6 +223,10 @@ run_failing_each_malloc (int n_mallocs,
}
/**
* test_oom_handling:
* @func: function to call
* @data: data to pass to function
*
* Tests how well the given function responds to out-of-memory
* situations. Calls the function repeatedly, failing a different
* call to malloc() each time. If the function ever returns #FALSE,
@ -223,9 +234,7 @@ run_failing_each_malloc (int n_mallocs,
* valid (such as returning an error, or succeeding) occurs, and #FALSE
* if it gets confused in some way.
*
* @param func function to call
* @param data data to pass to function
* @returns #TRUE if the function never returns FALSE
* Returns #TRUE if the function never returns FALSE
*/
int
test_oom_handling (TestMemoryFunction func,

View File

@ -438,7 +438,7 @@ xmlTextReaderFreeNode(xmlTextReaderPtr reader, xmlNodePtr cur) {
*
* Deallocate the memory used by an ID hash table.
*/
void
static void
xmlTextReaderFreeIDTable(xmlIDTablePtr table) {
xmlHashFree(table, (xmlHashDeallocator) xmlFreeID);
}