IF YOU WOULD LIKE TO GET AN ACCOUNT, please write an
email to Administrator. User accounts are meant only to access repo
and report issues and/or generate pull requests.
This is a purpose-specific Git hosting for
BaseALT
projects. Thank you for your understanding!
Только зарегистрированные пользователи имеют доступ к сервису!
Для получения аккаунта, обратитесь к администратору.
</pre><p>An <ahref="libxml-SAX.html#attribute">attribute</a> definition has been parsed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>elem</tt></i>:</span></td><td>the name of the element</td></tr><tr><td><spanclass="term"><i><tt>fullname</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> name</td></tr><tr><td><spanclass="term"><i><tt>type</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> type</td></tr><tr><td><spanclass="term"><i><tt>def</tt></i>:</span></td><td>the type of default value</td></tr><tr><td><spanclass="term"><i><tt>defaultValue</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> default value</td></tr><tr><td><spanclass="term"><i><tt>tree</tt></i>:</span></td><td>the tree of enumerated value set</td></tr></tbody></table></div><br/>
</pre><p>Get an entity by name.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>The entity name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> if found.</td></tr></tbody></table></div><br/>
</pre><p>Called when an opening tag has been processed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>The element name, including namespace prefix</td></tr><tr><td><spanclass="term"><i><tt>atts</tt></i>:</span></td><td>An array of name/value attributes pairs, NULL terminated</td></tr></tbody></table></div><br/>
</pre><p>Receiving some chars from the parser.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>ch</tt></i>:</span></td><td>a <ahref="libxml-tree.html#xmlChar">xmlChar</a> string</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the number of <ahref="libxml-tree.html#xmlChar">xmlChar</a></td></tr></tbody></table></div><br/>
</pre><p>What to do when an unparsed entity declaration is parsed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>The name of the entity</td></tr><tr><td><spanclass="term"><i><tt>publicId</tt></i>:</span></td><td>The public ID of the entity</td></tr><tr><td><spanclass="term"><i><tt>systemId</tt></i>:</span></td><td>The system ID of the entity</td></tr><tr><td><spanclass="term"><i><tt>notationName</tt></i>:</span></td><td>the name of the notation</td></tr></tbody></table></div><br/>
</pre><p>SAX2 callback when an element start has been detected by the parser. It provides the namespace informations for the element, as well as the new namespace declarations on the element.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>localname</tt></i>:</span></td><td>the local name of the element</td></tr><tr><td><spanclass="term"><i><tt>prefix</tt></i>:</span></td><td>the element namespace prefix if available</td></tr><tr><td><spanclass="term"><i><tt>URI</tt></i>:</span></td><td>the element namespace name if available</td></tr><tr><td><spanclass="term"><i><tt>nb_namespaces</tt></i>:</span></td><td>number of namespace definitions on that node</td></tr><tr><td><spanclass="term"><i><tt>namespaces</tt></i>:</span></td><td>pointer to the array of prefix/URI pairs namespace definitions</td></tr><tr><td><spanclass="term"><i><tt>nb_attributes</tt></i>:</span></td><td>the number of attributes on that node</td></tr><tr><td><spanclass="term"><i><tt>nb_defaulted</tt></i>:</span></td><td>the number of defaulted attributes. The defaulted ones are at the end of the array</td></tr><tr><td><spanclass="term"><i><tt>attributes</tt></i>:</span></td><td>pointer to the array of (localname/prefix/URI/value/end) <ahref="libxml-SAX.html#attribute">attribute</a> values.</td></tr></tbody></table></div><br/>
</pre><p>Called when an entity <ahref="libxml-SAX.html#reference">reference</a> is detected.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>The entity name</td></tr></tbody></table></div><br/>
</pre><p>Does this document has an external subset?</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>1 if true</td></tr></tbody></table></div><br/>
</pre><p>A processing instruction has been parsed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>target</tt></i>:</span></td><td>the target name</td></tr><tr><td><spanclass="term"><i><tt>data</tt></i>:</span></td><td>the PI data's</td></tr></tbody></table></div><br/>
</pre><p>Display and format an error messages, callback.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>msg</tt></i>:</span></td><td>the message to display/transmit</td></tr><tr><td><spanclass="term"><i><tt>...</tt></i>:</span></td><td>extra parameters for the message display</td></tr></tbody></table></div><br/>
<aname="XML_PARSER_EOF"id="XML_PARSER_EOF">XML_PARSER_EOF</a> = -1 : nothing is to be parsed
<aname="XML_PARSER_START"id="XML_PARSER_START">XML_PARSER_START</a> = 0 : nothing has been parsed
<aname="XML_PARSER_MISC"id="XML_PARSER_MISC">XML_PARSER_MISC</a> = 1 : Misc* before int subset
<aname="XML_PARSER_PI"id="XML_PARSER_PI">XML_PARSER_PI</a> = 2 : Within a processing instruction
<aname="XML_PARSER_DTD"id="XML_PARSER_DTD">XML_PARSER_DTD</a> = 3 : within some DTD content
<aname="XML_PARSER_PROLOG"id="XML_PARSER_PROLOG">XML_PARSER_PROLOG</a> = 4 : Misc* after internal subset
<aname="XML_PARSER_COMMENT"id="XML_PARSER_COMMENT">XML_PARSER_COMMENT</a> = 5 : within a <ahref="libxml-SAX.html#comment">comment</a>
<aname="XML_PARSER_START_TAG"id="XML_PARSER_START_TAG">XML_PARSER_START_TAG</a> = 6 : within a start tag
<aname="XML_PARSER_CONTENT"id="XML_PARSER_CONTENT">XML_PARSER_CONTENT</a> = 7 : within the content
<aname="XML_PARSER_CDATA_SECTION"id="XML_PARSER_CDATA_SECTION">XML_PARSER_CDATA_SECTION</a> = 8 : within a CDATA section
<aname="XML_PARSER_END_TAG"id="XML_PARSER_END_TAG">XML_PARSER_END_TAG</a> = 9 : within a closing tag
<aname="XML_PARSER_ENTITY_DECL"id="XML_PARSER_ENTITY_DECL">XML_PARSER_ENTITY_DECL</a> = 10 : within an entity declaration
<aname="XML_PARSER_ENTITY_VALUE"id="XML_PARSER_ENTITY_VALUE">XML_PARSER_ENTITY_VALUE</a> = 11 : within an entity value in a decl
<aname="XML_PARSER_ATTRIBUTE_VALUE"id="XML_PARSER_ATTRIBUTE_VALUE">XML_PARSER_ATTRIBUTE_VALUE</a> = 12 : within an <ahref="libxml-SAX.html#attribute">attribute</a> value
<aname="XML_PARSER_SYSTEM_LITERAL"id="XML_PARSER_SYSTEM_LITERAL">XML_PARSER_SYSTEM_LITERAL</a> = 13 : within a SYSTEM value
<aname="XML_PARSER_EPILOG"id="XML_PARSER_EPILOG">XML_PARSER_EPILOG</a> = 14 : the Misc* after the last end tag
<aname="XML_PARSER_IGNORE"id="XML_PARSER_IGNORE">XML_PARSER_IGNORE</a> = 15 : within an IGNORED section
<aname="XML_PARSER_PUBLIC_LITERAL"id="XML_PARSER_PUBLIC_LITERAL">XML_PARSER_PUBLIC_LITERAL</a> = 16 : within a PUBLIC value
}
</pre><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a><ahref="#xmlSAXParseMemory">xmlSAXParseMemory</a> (<ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/> const char * buffer, <br/> int size, <br/> int recovery)<br/>
</pre><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a><ahref="#xmlRecoverMemory">xmlRecoverMemory</a> (const char * buffer, <br/> int size)<br/>
</pre><p>External entity loaders types.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>The System ID of the resource requested</td></tr><tr><td><spanclass="term"><i><tt>ID</tt></i>:</span></td><td>The Public ID of the resource requested</td></tr><tr><td><spanclass="term"><i><tt>context</tt></i>:</span></td><td>the XML parser context</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the entity input parser.</td></tr></tbody></table></div><br/>
</pre><p>Does this document has an internal subset.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>1 if true</td></tr></tbody></table></div><br/>
</pre><p>Called when a pcdata block has been parsed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>The pcdata content</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the block length</td></tr></tbody></table></div><br/>
</pre><p>Callback for freeing some parser input allocations.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the string to deallocate</td></tr></tbody></table></div><br/>
</pre><p>A <ahref="libxml-SAX.html#comment">comment</a> has been parsed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#comment">comment</a> content</td></tr></tbody></table></div><br/>
</pre><p>Handle an <ahref="libxml-SAX.html#attribute">attribute</a> that has been read by the parser. The default handling is to convert the <ahref="libxml-SAX.html#attribute">attribute</a> into an DOM subtree and past it in a new <ahref="libxml-tree.html#xmlAttr">xmlAttr</a> element added to the element.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>The <ahref="libxml-SAX.html#attribute">attribute</a> name, including namespace prefix</td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>The <ahref="libxml-SAX.html#attribute">attribute</a> value</td></tr></tbody></table></div><br/>
</pre><preclass="programlisting">int <ahref="#xmlParserInputGrow">xmlParserInputGrow</a> (<ahref="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> in, <br/> int len)<br/>
</pre><p>Callback on external subset declaration.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the root element name</td></tr><tr><td><spanclass="term"><i><tt>ExternalID</tt></i>:</span></td><td>the external ID</td></tr><tr><td><spanclass="term"><i><tt>SystemID</tt></i>:</span></td><td>the SYSTEM ID (e.g. filename or URL)</td></tr></tbody></table></div><br/>
</pre><p>Callback: The entity loader, to control the loading of external entities, the application can either: - override this resolveEntity() callback in the SAX block - or better use the xmlSetExternalEntityLoader() function to set up it's own entity resolution routine</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>publicId</tt></i>:</span></td><td>The public ID of the entity</td></tr><tr><td><spanclass="term"><i><tt>systemId</tt></i>:</span></td><td>The system ID of the entity</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> if inlined or NULL for DOM behaviour.</td></tr></tbody></table></div><br/>
</pre><p>An element definition has been parsed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the element name</td></tr><tr><td><spanclass="term"><i><tt>type</tt></i>:</span></td><td>the element type</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the element value tree</td></tr></tbody></table></div><br/>
<preclass="programlisting">int <ahref="#xmlCtxtUseOptions">xmlCtxtUseOptions</a> (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> int options)<br/>
</pre><p>Callback on internal subset declaration.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the root element name</td></tr><tr><td><spanclass="term"><i><tt>ExternalID</tt></i>:</span></td><td>the external ID</td></tr><tr><td><spanclass="term"><i><tt>SystemID</tt></i>:</span></td><td>the SYSTEM ID (e.g. filename or URL)</td></tr></tbody></table></div><br/>
</pre><p>Called when the document end has been detected.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr></tbody></table></div><br/>
</pre><p>Receive the document locator at startup, actually xmlDefaultSAXLocator. Everything is available on the context, so this is useless in our case.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>loc</tt></i>:</span></td><td>A SAX Locator</td></tr></tbody></table></div><br/>
</pre><p>Called when the end of an element has been detected.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>The element name</td></tr></tbody></table></div><br/>
</pre><p>Get a parameter entity by name.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>The entity name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> if found.</td></tr></tbody></table></div><br/>
</pre><p>SAX2 callback when an element end has been detected by the parser. It provides the namespace informations for the element.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>localname</tt></i>:</span></td><td>the local name of the element</td></tr><tr><td><spanclass="term"><i><tt>prefix</tt></i>:</span></td><td>the element namespace prefix if available</td></tr><tr><td><spanclass="term"><i><tt>URI</tt></i>:</span></td><td>the element namespace name if available</td></tr></tbody></table></div><br/>
</pre><p>Receiving some ignorable whitespaces from the parser. UNUSED: by default the DOM building will use characters.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>ch</tt></i>:</span></td><td>a <ahref="libxml-tree.html#xmlChar">xmlChar</a> string</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the number of <ahref="libxml-tree.html#xmlChar">xmlChar</a></td></tr></tbody></table></div><br/>
</pre><preclass="programlisting">int <ahref="#xmlParserInputRead">xmlParserInputRead</a> (<ahref="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> in, <br/> int len)<br/>
</pre><p>Display and format fatal error messages, callback. Note: so far fatalError() SAX callbacks are not used, error() get all the callbacks for errors.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>msg</tt></i>:</span></td><td>the message to display/transmit</td></tr><tr><td><spanclass="term"><i><tt>...</tt></i>:</span></td><td>extra parameters for the message display</td></tr></tbody></table></div><br/>
</pre><p>An entity definition has been parsed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the entity name</td></tr><tr><td><spanclass="term"><i><tt>type</tt></i>:</span></td><td>the entity type</td></tr><tr><td><spanclass="term"><i><tt>publicId</tt></i>:</span></td><td>The public ID of the entity</td></tr><tr><td><spanclass="term"><i><tt>systemId</tt></i>:</span></td><td>The system ID of the entity</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the entity value (without processing).</td></tr></tbody></table></div><br/>
</pre><p>Is this document tagged standalone?</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>1 if true</td></tr></tbody></table></div><br/>
</pre><p>Called when the document start being processed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr></tbody></table></div><br/>
</pre><p>What to do when a notation declaration has been parsed.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the user data (XML parser context)</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>The name of the notation</td></tr><tr><td><spanclass="term"><i><tt>publicId</tt></i>:</span></td><td>The public ID of the entity</td></tr><tr><td><spanclass="term"><i><tt>systemId</tt></i>:</span></td><td>The system ID of the entity</td></tr></tbody></table></div><br/>
</pre><p>Display and format a warning messages, callback.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>msg</tt></i>:</span></td><td>the message to display/transmit</td></tr><tr><td><spanclass="term"><i><tt>...</tt></i>:</span></td><td>extra parameters for the message display</td></tr></tbody></table></div><br/>
</pre><p>Setup the parser context to parse a new buffer; Clears any prior contents from the parser context. The buffer parameter must not be NULL, but the filename parameter can be</p>
</pre><p>parse an XML file from the filesystem or the network. This reuses the existing @ctxt parser context</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>a file or URL</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlStrcmp"id="xmlStrcmp"></a>Function: xmlStrcmp</h3><preclass="programlisting">int xmlStrcmp (const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str1, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str2)<br/>
</pre><p>a strcmp for xmlChar's</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str1</tt></i>:</span></td><td>the first <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>str2</tt></i>:</span></td><td>the second <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the integer result of the comparison</td></tr></tbody></table></div><h3><aname="xmlParseMemory"id="xmlParseMemory"></a>Function: xmlParseMemory</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlParseMemory (const char * buffer, <br/> int size)<br/>
</pre><p>parse an XML in-memory block and build a tree.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buffer</tt></i>:</span></td><td>an pointer to a char array</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the size of the array</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlParseCtxtExternalEntity"id="xmlParseCtxtExternalEntity"></a>Function: xmlParseCtxtExternalEntity</h3><preclass="programlisting">int xmlParseCtxtExternalEntity (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctx, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * URL, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * ID, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> * lst)<br/>
</pre><p>Parse an external general entity within an existing parsing context An external general parsed entity is well-formed if it matches the production labeled extParsedEnt. [78] extParsedEnt ::= TextDecl? content</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>the existing parsing context</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the URL for the entity to load</td></tr><tr><td><spanclass="term"><i><tt>ID</tt></i>:</span></td><td>the System ID for the entity to load</td></tr><tr><td><spanclass="term"><i><tt>lst</tt></i>:</span></td><td>the return value for the set of parsed nodes</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the entity is well formed, -1 in case of args problem and the parser error code otherwise</td></tr></tbody></table></div>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array (haystack)</td></tr><tr><td><spanclass="term"><i><tt>val</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> to search (needle)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * for the first occurrence or NULL.</td></tr></tbody></table></div><h3><aname="xmlStrcat"id="xmlStrcat"></a>Function: xmlStrcat</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlChar">xmlChar</a> * xmlStrcat (<ahref="libxml-tree.html#xmlChar">xmlChar</a> * cur, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * add)<br/>
</pre><p>a strcat for array of xmlChar's. Since they are supposed to be encoded in UTF-8 or an encoding with 8bit based chars, we assume a termination mark of '0'.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the original <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array</td></tr><tr><td><spanclass="term"><i><tt>add</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array added</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new <ahref="libxml-tree.html#xmlChar">xmlChar</a> * containing the concatenated string.</td></tr></tbody></table></div>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array (haystack)</td></tr><tr><td><spanclass="term"><i><tt>val</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> to search (needle)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * for the first occurrence or NULL.</td></tr></tbody></table></div>
</pre><p>-- Clear (release memory and reinitialize) node info sequence</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>seq</tt></i>:</span></td><td>a node info sequence pointer</td></tr></tbody></table></div><h3><aname="xmlParseChunk"id="xmlParseChunk"></a>Function: xmlParseChunk</h3><preclass="programlisting">int xmlParseChunk (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> const char * chunk, <br/> int size, <br/> int terminate)<br/>
</pre><p>Parse a Chunk of memory</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>chunk</tt></i>:</span></td><td>an char array</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the size in byte of the chunk</td></tr><tr><td><spanclass="term"><i><tt>terminate</tt></i>:</span></td><td>last chunk indicator</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>zero if no error, the <ahref="libxml-xmlerror.html#xmlParserErrors">xmlParserErrors</a> otherwise.</td></tr></tbody></table></div><h3><aname="xmlReadMemory"id="xmlReadMemory"></a>Function: xmlReadMemory</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlReadMemory (const char * buffer, <br/> int size, <br/> const char * URL, <br/> const char * encoding, <br/> int options)<br/>
</pre><p>parse an XML in-memory document and build a tree.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buffer</tt></i>:</span></td><td>a pointer to a char array</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the size of the array</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the base URL to use for the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlParseEntity"id="xmlParseEntity"></a>Function: xmlParseEntity</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlParseEntity (const char * filename)<br/>
</pre><p>parse an XML external entity out of context and build a tree. [78] extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk</p>
</pre><p>parse an XML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. In the case the document is not Well Formed, a tree is built anyway</p>
</pre><p>a strdup for array of xmlChar's. Since they are supposed to be encoded in UTF-8 or an encoding with 8bit based chars, we assume a termination mark of '0'.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the input <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new <ahref="libxml-tree.html#xmlChar">xmlChar</a> * or NULL</td></tr></tbody></table></div>
What to do when an unparsed entity declaration is parsed.
SAX2 callback when an element start has been detected by the parser. It provides the namespace informations for the element, as well as the new namespace declarations on the element.
</pre><p>Create a parser context for using the XML parser with an existing I/O stream</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>a SAX handler</td></tr><tr><td><spanclass="term"><i><tt>user_data</tt></i>:</span></td><td>The user data returned on SAX callbacks</td></tr><tr><td><spanclass="term"><i><tt>ioread</tt></i>:</span></td><td>an I/O read function</td></tr><tr><td><spanclass="term"><i><tt>ioclose</tt></i>:</span></td><td>an I/O close function</td></tr><tr><td><spanclass="term"><i><tt>ioctx</tt></i>:</span></td><td>an I/O handler</td></tr><tr><td><spanclass="term"><i><tt>enc</tt></i>:</span></td><td>the charset encoding if known</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new parser context or NULL</td></tr></tbody></table></div>
</pre><p>a strncat for array of xmlChar's, it will extend @cur with the len first bytes of @add.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the original <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array</td></tr><tr><td><spanclass="term"><i><tt>add</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array added</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the length of @add</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new <ahref="libxml-tree.html#xmlChar">xmlChar</a> *, the original @cur is reallocated if needed and should not be freed</td></tr></tbody></table></div>
</pre><p>Formats @msg and places result into @buf.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the result buffer.</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the result buffer length.</td></tr><tr><td><spanclass="term"><i><tt>msg</tt></i>:</span></td><td>the message with printf formatting.</td></tr><tr><td><spanclass="term"><i><tt>...</tt></i>:</span></td><td>extra parameters for the message.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of <ahref="libxml-SAX.html#characters">characters</a> written to @buf or -1 if an error occurs.</td></tr></tbody></table></div><h3><aname="xmlSAXParseDoc"id="xmlSAXParseDoc"></a>Function: xmlSAXParseDoc</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlSAXParseDoc (<ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/><ahref="libxml-tree.html#xmlChar">xmlChar</a> * cur, <br/> int recovery)<br/>
</pre><p>parse an XML 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>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler block</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>a pointer to an array of <ahref="libxml-tree.html#xmlChar">xmlChar</a></td></tr><tr><td><spanclass="term"><i><tt>recovery</tt></i>:</span></td><td>work in recovery mode, i.e. tries to read no Well Formed documents</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlStrndup"id="xmlStrndup"></a>Function: xmlStrndup</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlChar">xmlChar</a> * xmlStrndup (const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * cur, <br/> int len)<br/>
</pre><p>a strndup for array of xmlChar's</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the input <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the len of @cur</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new <ahref="libxml-tree.html#xmlChar">xmlChar</a> * or NULL</td></tr></tbody></table></div><h3><aname="xmlCharStrdup"id="xmlCharStrdup"></a>Function: xmlCharStrdup</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlChar">xmlChar</a> * xmlCharStrdup (const char * cur)<br/>
</pre><p>a strdup for char's to xmlChar's</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the input char *</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new <ahref="libxml-tree.html#xmlChar">xmlChar</a> * or NULL</td></tr></tbody></table></div><h3><aname="xmlNewIOInputStream"id="xmlNewIOInputStream"></a>Function: xmlNewIOInputStream</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> xmlNewIOInputStream (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/><ahref="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> input, <br/><ahref="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc)<br/>
</pre><p>Create a new input stream structure encapsulating the @input into a stream suitable for the parser.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>input</tt></i>:</span></td><td>an I/O Input</td></tr><tr><td><spanclass="term"><i><tt>enc</tt></i>:</span></td><td>the charset encoding if known</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new input stream or NULL</td></tr></tbody></table></div>
</pre><p>Parse a well-balanced chunk of an XML document called by the parser The allowed sequence for the Well Balanced Chunk is the one defined by the content production in the XML grammar: [43] content ::= (element | CharData | Reference | CDSect | PI | Comment)*</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document the chunk pertains to</td></tr><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler bloc (possibly NULL)</td></tr><tr><td><spanclass="term"><i><tt>user_data</tt></i>:</span></td><td>The user data returned on SAX callbacks (possibly NULL)</td></tr><tr><td><spanclass="term"><i><tt>depth</tt></i>:</span></td><td>Used for loop detection, use 0</td></tr><tr><td><spanclass="term"><i><tt>string</tt></i>:</span></td><td>the input string in UTF8 or ISO-Latin (zero terminated)</td></tr><tr><td><spanclass="term"><i><tt>lst</tt></i>:</span></td><td>the return value for the set of parsed nodes</td></tr><tr><td><spanclass="term"><i><tt>recover</tt></i>:</span></td><td>return nodes even if the data is broken (use 0)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the chunk is well balanced, -1 in case of args problem and the parser error code otherwise In case recover is set to 1, the nodelist will not be empty even if the parsed chunk is not well balanced.</td></tr></tbody></table></div><h3><aname="xmlInitParser"id="xmlInitParser"></a>Function: xmlInitParser</h3><preclass="programlisting">void xmlInitParser (void)<br/>
</pre><p>Initialization function for the XML parser. This is not reentrant. Call once before processing in case of use in multithreaded programs.</p>
Display and format an error messages, callback.
<h3><aname="xmlSAXParseMemory"id="xmlSAXParseMemory"></a>Function: xmlSAXParseMemory</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlSAXParseMemory (<ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/> const char * buffer, <br/> int size, <br/> int recovery)<br/>
</pre><p>parse an XML in-memory block and use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler block</td></tr><tr><td><spanclass="term"><i><tt>buffer</tt></i>:</span></td><td>an pointer to a char array</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the size of the array</td></tr><tr><td><spanclass="term"><i><tt>recovery</tt></i>:</span></td><td>work in recovery mode, i.e. tries to read not Well Formed documents</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlRecoverMemory"id="xmlRecoverMemory"></a>Function: xmlRecoverMemory</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlRecoverMemory (const char * buffer, <br/> int size)<br/>
</pre><p>parse an XML in-memory block and build a tree. In the case the document is not Well Formed, a tree is built anyway</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buffer</tt></i>:</span></td><td>an pointer to a char array</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the size of the array</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div>
</pre><p>parse an XML in-memory document and build a tree.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>a pointer to a zero terminated string</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the base URL to use for the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div>
Called when a pcdata block has been parsed.
<h3><aname="XML_COMPLETE_ATTRS"id="XML_COMPLETE_ATTRS"></a>Macro: XML_COMPLETE_ATTRS</h3><pre>#define XML_COMPLETE_ATTRS</pre><p>Bit in the loadsubset context field to tell to do complete the elements attributes lists with the ones defaulted from the DTDs. Use it to initialize xmlLoadExtDtdDefaultValue.</p>
</pre><p>parse an XML 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>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler block</td></tr><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>the filename</td></tr><tr><td><spanclass="term"><i><tt>recovery</tt></i>:</span></td><td>work in recovery mode, i.e. tries to read no Well Formed documents</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div>
Callback for freeing some parser input allocations.
</pre><p>parse an XML document from I/O functions and source and build a tree. This reuses the existing @ctxt parser context</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>ioread</tt></i>:</span></td><td>an I/O read function</td></tr><tr><td><spanclass="term"><i><tt>ioclose</tt></i>:</span></td><td>an I/O close function</td></tr><tr><td><spanclass="term"><i><tt>ioctx</tt></i>:</span></td><td>an I/O handler</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the base URL to use for the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlSAXParseMemoryWithData"id="xmlSAXParseMemoryWithData"></a>Function: xmlSAXParseMemoryWithData</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlSAXParseMemoryWithData (<ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/> const char * buffer, <br/> int size, <br/> int recovery, <br/> void * data)<br/>
</pre><p>parse an XML in-memory block and use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. User data (void *) is stored within the parser context in the context's _private member, so it is available nearly everywhere in libxml</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler block</td></tr><tr><td><spanclass="term"><i><tt>buffer</tt></i>:</span></td><td>an pointer to a char array</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the size of the array</td></tr><tr><td><spanclass="term"><i><tt>recovery</tt></i>:</span></td><td>work in recovery mode, i.e. tries to read no Well Formed documents</td></tr><tr><td><spanclass="term"><i><tt>data</tt></i>:</span></td><td>the userdata</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlParserFindNodeInfo"id="xmlParserFindNodeInfo"></a>Function: xmlParserFindNodeInfo</h3><preclass="programlisting">const <ahref="libxml-parser.html#xmlParserNodeInfo">xmlParserNodeInfo</a> * xmlParserFindNodeInfo (const <ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctx, <br/> const <ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node)<br/>
</pre><p>Find the parser node info struct for a given node</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctx</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>an XML node within the tree</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>an <ahref="libxml-parser.html#xmlParserNodeInfo">xmlParserNodeInfo</a> block pointer or NULL</td></tr></tbody></table></div><h3><aname="xmlGetFeature"id="xmlGetFeature"></a>Function: xmlGetFeature</h3><preclass="programlisting">int xmlGetFeature (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> const char * name, <br/> void * result)<br/>
</pre><p>Read the current value of one feature of this parser instance</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML/HTML parser context</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the feature name</td></tr><tr><td><spanclass="term"><i><tt>result</tt></i>:</span></td><td>location to store the result</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case or error, 0 otherwise</td></tr></tbody></table></div>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array</td></tr><tr><td><spanclass="term"><i><tt>val</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> to search</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * for the first occurrence or NULL.</td></tr></tbody></table></div><h3><aname="xmlIOParseDTD"id="xmlIOParseDTD"></a>Function: xmlIOParseDTD</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> xmlIOParseDTD (<ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/><ahref="libxml-tree.html#xmlParserInputBufferPtr">xmlParserInputBufferPtr</a> input, <br/><ahref="libxml-encoding.html#xmlCharEncoding">xmlCharEncoding</a> enc)<br/>
</pre><p>Load and parse a DTD</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler block or NULL</td></tr><tr><td><spanclass="term"><i><tt>input</tt></i>:</span></td><td>an Input Buffer</td></tr><tr><td><spanclass="term"><i><tt>enc</tt></i>:</span></td><td>the charset encoding if known</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting <ahref="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> or NULL in case of error. @input will be freed at parsing end.</td></tr></tbody></table></div><h3><aname="xmlFreeParserCtxt"id="xmlFreeParserCtxt"></a>Function: xmlFreeParserCtxt</h3><preclass="programlisting">void xmlFreeParserCtxt (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt)<br/>
</pre><p>Free all the memory used by a parser context. However the parsed document in ctxt->myDoc is not freed.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ExternalID</tt></i>:</span></td><td>a NAME* containing the External ID of the DTD</td></tr><tr><td><spanclass="term"><i><tt>SystemID</tt></i>:</span></td><td>a NAME* containing the URL to the DTD</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting <ahref="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> or NULL in case of error.</td></tr></tbody></table></div>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and -1 in case of error</td></tr></tbody></table></div>
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.
</pre><p>Check if a QName is Equal to a given string</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>pref</tt></i>:</span></td><td>the prefix of the QName</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the localname of the QName</td></tr><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the second <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>1 if they are equal, 0 if they are different</td></tr></tbody></table></div><h3><aname="xmlParserInputGrow"id="xmlParserInputGrow"></a>Function: xmlParserInputGrow</h3><preclass="programlisting">int xmlParserInputGrow (<ahref="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> in, <br/> int len)<br/>
</pre><p>This function increase the input for the parser. It tries to preserve pointers to the input buffer, and keep already read data</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>in</tt></i>:</span></td><td>an XML parser input</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>an indicative size for the lookahead</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of xmlChars read, or -1 in case of error, 0 indicate the end of this entity</td></tr></tbody></table></div><h3><aname="xmlCtxtReadMemory"id="xmlCtxtReadMemory"></a>Function: xmlCtxtReadMemory</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlCtxtReadMemory (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> const char * buffer, <br/> int size, <br/> const char * URL, <br/> const char * encoding, <br/> int options)<br/>
</pre><p>parse an XML in-memory document and build a tree. This reuses the existing @ctxt parser context</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>buffer</tt></i>:</span></td><td>a pointer to a char array</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the size of the array</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the base URL to use for the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div>
Callback on external subset declaration.
Callback: The entity loader, to control the loading of external entities, the application can either: - override this resolveEntity() callback in the SAX block - or better use the xmlSetExternalEntityLoader() function to set up it's own entity resolution routine
</pre><p>Set and return the previous value for enabling pedantic warnings.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>val</tt></i>:</span></td><td>int 0 or 1</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the last value for 0 for no substitution, 1 for substitution.</td></tr></tbody></table></div><h3><aname="xmlSAXParseEntity"id="xmlSAXParseEntity"></a>Function: xmlSAXParseEntity</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlSAXParseEntity (<ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/> const char * filename)<br/>
</pre><p>parse an XML external entity out of context 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. [78] extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk</p>
</pre><p>parse an XML in-memory document and build a tree.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>a pointer to an array of <ahref="libxml-tree.html#xmlChar">xmlChar</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlParserAddNodeInfo"id="xmlParserAddNodeInfo"></a>Function: xmlParserAddNodeInfo</h3><preclass="programlisting">void xmlParserAddNodeInfo (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> const <ahref="libxml-parser.html#xmlParserNodeInfoPtr">xmlParserNodeInfoPtr</a> info)<br/>
</pre><p>Insert node info record into the sorted sequence</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>info</tt></i>:</span></td><td>a node info sequence pointer</td></tr></tbody></table></div><h3><aname="XML_SAX2_MAGIC"id="XML_SAX2_MAGIC"></a>Macro: XML_SAX2_MAGIC</h3><pre>#define XML_SAX2_MAGIC</pre><p>Special constant found in SAX2 blocks initialized fields</p>
</pre><p>parse an XML 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. User data (void *) is stored within the parser context in the context's _private member, so it is available nearly everywhere in libxml</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler block</td></tr><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>the filename</td></tr><tr><td><spanclass="term"><i><tt>recovery</tt></i>:</span></td><td>work in recovery mode, i.e. tries to read no Well Formed documents</td></tr><tr><td><spanclass="term"><i><tt>data</tt></i>:</span></td><td>the userdata</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlLineNumbersDefault"id="xmlLineNumbersDefault"></a>Function: xmlLineNumbersDefault</h3><preclass="programlisting">int xmlLineNumbersDefault (int val)<br/>
</pre><p>Set and return the previous value for enabling line numbers in elements contents. This may break on old application and is turned off by default.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>val</tt></i>:</span></td><td>int 0 or 1</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the last value for 0 for no substitution, 1 for substitution.</td></tr></tbody></table></div><h3><aname="xmlGetExternalEntityLoader"id="xmlGetExternalEntityLoader"></a>Function: xmlGetExternalEntityLoader</h3><preclass="programlisting"><ahref="libxml-parser.html#xmlExternalEntityLoader">xmlExternalEntityLoader</a> xmlGetExternalEntityLoader (void)<br/>
</pre><p>Get the default external entity resolver function for the application</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-parser.html#xmlExternalEntityLoader">xmlExternalEntityLoader</a> function pointer</td></tr></tbody></table></div>
An element definition has been parsed.
<h3><aname="xmlCtxtUseOptions"id="xmlCtxtUseOptions"></a>Function: xmlCtxtUseOptions</h3><preclass="programlisting">int xmlCtxtUseOptions (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> int options)<br/>
</pre><p>Applies the options to the parser context</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success, the set of unknown or unimplemented options in case of error.</td></tr></tbody></table></div><h3><aname="xmlCreatePushParserCtxt"id="xmlCreatePushParserCtxt"></a>Function: xmlCreatePushParserCtxt</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> xmlCreatePushParserCtxt (<ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/> void * user_data, <br/> const char * chunk, <br/> int size, <br/> const char * filename)<br/>
</pre><p>Create a parser context for using the XML parser in push mode. If @buffer and @size are non-NULL, the data is used to detect the encoding. The remaining <ahref="libxml-SAX.html#characters">characters</a> will be parsed so they don't need to be fed in again through xmlParseChunk. To allow content encoding detection, @size should be >= 4 The value of @filename is used for fetching external entities and error/warning reports.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>a SAX handler</td></tr><tr><td><spanclass="term"><i><tt>user_data</tt></i>:</span></td><td>The user data returned on SAX callbacks</td></tr><tr><td><spanclass="term"><i><tt>chunk</tt></i>:</span></td><td>a pointer to an array of chars</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>number of chars in the array</td></tr><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>an optional file name or URI</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new parser context or NULL</td></tr></tbody></table></div><h3><aname="xmlCharStrndup"id="xmlCharStrndup"></a>Function: xmlCharStrndup</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlChar">xmlChar</a> * xmlCharStrndup (const char * cur, <br/> int len)<br/>
</pre><p>a strndup for char's to xmlChar's</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the input char *</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the len of @cur</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new <ahref="libxml-tree.html#xmlChar">xmlChar</a> * or NULL</td></tr></tbody></table></div><h3><aname="xmlCtxtReadFd"id="xmlCtxtReadFd"></a>Function: xmlCtxtReadFd</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlCtxtReadFd (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> int fd, <br/> const char * URL, <br/> const char * encoding, <br/> int options)<br/>
</pre><p>parse an XML from a file descriptor and build a tree. This reuses the existing @ctxt parser context</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>fd</tt></i>:</span></td><td>an open file descriptor</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the base URL to use for the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div>
</pre><p>Allocate and initialize a new parser context.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> or NULL</td></tr></tbody></table></div>
</pre><p>parse an XML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>the filename</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree if the file was wellformed, NULL otherwise.</td></tr></tbody></table></div><h3><aname="xmlParseDocument"id="xmlParseDocument"></a>Function: xmlParseDocument</h3><preclass="programlisting">int xmlParseDocument (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt)<br/>
</pre><p>parse an XML document (and build a tree if using the standard SAX interface). [1] document ::= prolog element Misc* [22] prolog ::= XMLDecl? Misc* (doctypedecl Misc*)?</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</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><h3><aname="xmlStrncmp"id="xmlStrncmp"></a>Function: xmlStrncmp</h3><preclass="programlisting">int xmlStrncmp (const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str1, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str2, <br/> int len)<br/>
</pre><p>a strncmp for xmlChar's</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str1</tt></i>:</span></td><td>the first <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>str2</tt></i>:</span></td><td>the second <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the max comparison length</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the integer result of the comparison</td></tr></tbody></table></div>
Receive the document locator at startup, actually xmlDefaultSAXLocator. Everything is available on the context, so this is useless in our case.
Called when the end of an element has been detected.
<h3><aname="XML_DETECT_IDS"id="XML_DETECT_IDS"></a>Macro: XML_DETECT_IDS</h3><pre>#define XML_DETECT_IDS</pre><p>Bit in the loadsubset context field to tell to do ID/REFs lookups. Use it to initialize xmlLoadExtDtdDefaultValue.</p>
Get a parameter entity by name.
SAX2 callback when an element end has been detected by the parser. It provides the namespace informations for the element.
Receiving some ignorable whitespaces from the parser. UNUSED: by default the DOM building will use characters.
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of <ahref="libxml-tree.html#xmlChar">xmlChar</a> contained in the ARRAY.</td></tr></tbody></table></div><h3><aname="xmlSubstituteEntitiesDefault"id="xmlSubstituteEntitiesDefault"></a>Function: xmlSubstituteEntitiesDefault</h3><preclass="programlisting">int xmlSubstituteEntitiesDefault (int val)<br/>
</pre><p>Set and return the previous value for default entity support. Initially the parser always keep entity references instead of substituting entity values in the output. This function has to be used to change the default parser behavior SAX::substituteEntities() has to be used for changing that on a file by file basis.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>val</tt></i>:</span></td><td>int 0 or 1</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the last value for 0 for no substitution, 1 for substitution.</td></tr></tbody></table></div><h3><aname="xmlStrncasecmp"id="xmlStrncasecmp"></a>Function: xmlStrncasecmp</h3><preclass="programlisting">int xmlStrncasecmp (const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str1, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str2, <br/> int len)<br/>
</pre><p>a strncasecmp for xmlChar's</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str1</tt></i>:</span></td><td>the first <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>str2</tt></i>:</span></td><td>the second <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the max comparison length</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the integer result of the comparison</td></tr></tbody></table></div><h3><aname="xmlParserFindNodeInfoIndex"id="xmlParserFindNodeInfoIndex"></a>Function: xmlParserFindNodeInfoIndex</h3><preclass="programlisting">unsigned long xmlParserFindNodeInfoIndex (const <ahref="libxml-parser.html#xmlParserNodeInfoSeqPtr">xmlParserNodeInfoSeqPtr</a> seq, <br/> const <ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node)<br/>
</pre><p><ahref="libxml-parser.html#xmlParserFindNodeInfoIndex">xmlParserFindNodeInfoIndex</a> : Find the index that the info record for the given node is or should be at in a sorted sequence</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>seq</tt></i>:</span></td><td>a node info sequence pointer</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>an XML node pointer</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a long indicating the position of the record</td></tr></tbody></table></div><h3><aname="xmlSAXUserParseMemory"id="xmlSAXUserParseMemory"></a>Function: xmlSAXUserParseMemory</h3><preclass="programlisting">int xmlSAXUserParseMemory (<ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/> void * user_data, <br/> const char * buffer, <br/> int size)<br/>
</pre><p>A better SAX parsing routine. parse an XML in-memory buffer and call the given SAX handler routines.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>a SAX handler</td></tr><tr><td><spanclass="term"><i><tt>user_data</tt></i>:</span></td><td>The user data returned on SAX callbacks</td></tr><tr><td><spanclass="term"><i><tt>buffer</tt></i>:</span></td><td>an in-memory XML document input</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the length of the XML document in bytes</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success or a error number otherwise</td></tr></tbody></table></div><h3><aname="xmlCtxtReset"id="xmlCtxtReset"></a>Function: xmlCtxtReset</h3><preclass="programlisting">void xmlCtxtReset (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt)<br/>
</pre><p>Change the current value of one feature of this parser instance</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML/HTML parser context</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the feature name</td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>pointer to the location of the new value</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case or error, 0 otherwise</td></tr></tbody></table></div><h3><aname="xmlStrEqual"id="xmlStrEqual"></a>Function: xmlStrEqual</h3><preclass="programlisting">int xmlStrEqual (const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str1, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str2)<br/>
</pre><p>Check if both string are equal of have same content Should be a bit more readable and faster than xmlStrEqual()</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str1</tt></i>:</span></td><td>the first <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>str2</tt></i>:</span></td><td>the second <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>1 if they are equal, 0 if they are different</td></tr></tbody></table></div><h3><aname="xmlKeepBlanksDefault"id="xmlKeepBlanksDefault"></a>Function: xmlKeepBlanksDefault</h3><preclass="programlisting">int xmlKeepBlanksDefault (int val)<br/>
</pre><p>Set and return the previous value for default blanks text nodes support. The 1.x version of the parser used an heuristic to try to detect ignorable white spaces. As a result the SAX callback was generating xmlSAX2IgnorableWhitespace() callbacks instead of characters() one, and when using the DOM output text nodes containing those blanks were not generated. The 2.x and later version will switch to the XML standard way and ignorableWhitespace() are only generated when running the parser in validating mode and when the current element doesn't allow CDATA or mixed content. This function is provided as a way to force the standard behavior on 1.X libs and to switch back to the old mode for compatibility when running 1.X client code on 2.X . Upgrade of 1.X code should be done by using xmlIsBlankNode() commodity function to detect the "empty" nodes generated. This value also affect autogeneration of indentation when saving code if blanks sections are kept, indentation is not generated.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>val</tt></i>:</span></td><td>int 0 or 1</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the last value for 0 for no substitution, 1 for substitution.</td></tr></tbody></table></div><h3><aname="xmlParserInputRead"id="xmlParserInputRead"></a>Function: xmlParserInputRead</h3><preclass="programlisting">int xmlParserInputRead (<ahref="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> in, <br/> int len)<br/>
</pre><p>This function refresh the input for the parser. It doesn't try to preserve pointers to the input buffer, and discard already read data</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>in</tt></i>:</span></td><td>an XML parser input</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>an indicative size for the lookahead</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of xmlChars read, or -1 in case of error, 0 indicate the end of this entity</td></tr></tbody></table></div><h3><aname="xmlReadFile"id="xmlReadFile"></a>Function: xmlReadFile</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlReadFile (const char * filename, <br/> const char * encoding, <br/> int options)<br/>
</pre><p>parse an XML file from the filesystem or the network.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>a file or URL</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlGetFeaturesList"id="xmlGetFeaturesList"></a>Function: xmlGetFeaturesList</h3><preclass="programlisting">int xmlGetFeaturesList (int * len, <br/> const char ** result)<br/>
</pre><p>Copy at most *@len feature names into the @result array</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the length of the features name array (input/output)</td></tr><tr><td><spanclass="term"><i><tt>result</tt></i>:</span></td><td>an array of string to be filled with the features name.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case or error, or the total number of features, len is updated with the number of strings copied, strings must not be deallocated</td></tr></tbody></table></div><h3><aname="xmlCtxtReadDoc"id="xmlCtxtReadDoc"></a>Function: xmlCtxtReadDoc</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlCtxtReadDoc (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * cur, <br/> const char * URL, <br/> const char * encoding, <br/> int options)<br/>
</pre><p>parse an XML in-memory document and build a tree. This reuses the existing @ctxt parser context</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>a pointer to a zero terminated string</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the base URL to use for the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div>
</pre><p>parse an XML file and call the given SAX handler routines. Automatic support for ZLIB/Compress compressed document is provided</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>a SAX handler</td></tr><tr><td><spanclass="term"><i><tt>user_data</tt></i>:</span></td><td>The user data returned on SAX callbacks</td></tr><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>a file name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success or a error number otherwise</td></tr></tbody></table></div>
Display and format fatal error messages, callback. Note: so far fatalError() SAX callbacks are not used, error() get all the callbacks for errors.
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler block</td></tr><tr><td><spanclass="term"><i><tt>ExternalID</tt></i>:</span></td><td>a NAME* containing the External ID of the DTD</td></tr><tr><td><spanclass="term"><i><tt>SystemID</tt></i>:</span></td><td>a NAME* containing the URL to the DTD</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting <ahref="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> or NULL in case of error.</td></tr></tbody></table></div>
</pre><p>Load an external entity, note that the use of this function for unparsed entities may generate problems TODO: a more generic External entity API must be designed</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the URL for the entity to load</td></tr><tr><td><spanclass="term"><i><tt>ID</tt></i>:</span></td><td>the Public ID for the entity to load</td></tr><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>the context in which the entity is called or NULL</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlParserInputPtr">xmlParserInputPtr</a> or NULL</td></tr></tbody></table></div><h3><aname="XML_DEFAULT_VERSION"id="XML_DEFAULT_VERSION"></a>Macro: XML_DEFAULT_VERSION</h3><pre>#define XML_DEFAULT_VERSION</pre><p>The default version of XML used: 1.0</p>
</pre><p>parse an XML from a file descriptor and build a tree.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>fd</tt></i>:</span></td><td>an open file descriptor</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the base URL to use for the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlParseExtParsedEnt"id="xmlParseExtParsedEnt"></a>Function: xmlParseExtParsedEnt</h3><preclass="programlisting">int xmlParseExtParsedEnt (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt)<br/>
</pre><p>parse a general parsed entity An external general parsed entity is well-formed if it matches the production labeled extParsedEnt. [78] extParsedEnt ::= TextDecl? content</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</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><h3><aname="xmlReadIO"id="xmlReadIO"></a>Function: xmlReadIO</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlReadIO (<ahref="libxml-xmlIO.html#xmlInputReadCallback">xmlInputReadCallback</a> ioread, <br/><ahref="libxml-xmlIO.html#xmlInputCloseCallback">xmlInputCloseCallback</a> ioclose, <br/> void * ioctx, <br/> const char * URL, <br/> const char * encoding, <br/> int options)<br/>
</pre><p>parse an XML document from I/O functions and source and build a tree.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ioread</tt></i>:</span></td><td>an I/O read function</td></tr><tr><td><spanclass="term"><i><tt>ioclose</tt></i>:</span></td><td>an I/O close function</td></tr><tr><td><spanclass="term"><i><tt>ioctx</tt></i>:</span></td><td>an I/O handler</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the base URL to use for the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>a combination of xmlParserOption(s)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlStrVPrintf"id="xmlStrVPrintf"></a>Function: xmlStrVPrintf</h3><preclass="programlisting">int xmlStrVPrintf (<ahref="libxml-tree.html#xmlChar">xmlChar</a> * buf, <br/> int len, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * msg, <br/> va_list ap)<br/>
</pre><p>Formats @msg and places result into @buf.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the result buffer.</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the result buffer length.</td></tr><tr><td><spanclass="term"><i><tt>msg</tt></i>:</span></td><td>the message with printf formatting.</td></tr><tr><td><spanclass="term"><i><tt>ap</tt></i>:</span></td><td>extra parameters for the message.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of <ahref="libxml-SAX.html#characters">characters</a> written to @buf or -1 if an error occurs.</td></tr></tbody></table></div><h3><aname="xmlCreateDocParserCtxt"id="xmlCreateDocParserCtxt"></a>Function: xmlCreateDocParserCtxt</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> xmlCreateDocParserCtxt (const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * cur)<br/>
</pre><p>Creates a parser context for an XML in-memory document.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>a pointer to an array of <ahref="libxml-tree.html#xmlChar">xmlChar</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new parser context or NULL</td></tr></tbody></table></div><h3><aname="xmlStrsub"id="xmlStrsub"></a>Function: xmlStrsub</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlChar">xmlChar</a> * xmlStrsub (const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * str, <br/> int start, <br/> int len)<br/>
</pre><p>Extract a substring of a given string</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * array (haystack)</td></tr><tr><td><spanclass="term"><i><tt>start</tt></i>:</span></td><td>the index of the first char (zero based)</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the length of the substring</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlChar">xmlChar</a> * for the first occurrence or NULL.</td></tr></tbody></table></div><h3><aname="xmlParseBalancedChunkMemory"id="xmlParseBalancedChunkMemory"></a>Function: xmlParseBalancedChunkMemory</h3><preclass="programlisting">int xmlParseBalancedChunkMemory (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlSAXHandlerPtr">xmlSAXHandlerPtr</a> sax, <br/> void * user_data, <br/> int depth, <br/> const <ahref="libxml-tree.html#xmlChar">xmlChar</a> * string, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> * lst)<br/>
</pre><p>Parse a well-balanced chunk of an XML document called by the parser The allowed sequence for the Well Balanced Chunk is the one defined by the content production in the XML grammar: [43] content ::= (element | CharData | Reference | CDSect | PI | Comment)*</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document the chunk pertains to</td></tr><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler bloc (possibly NULL)</td></tr><tr><td><spanclass="term"><i><tt>user_data</tt></i>:</span></td><td>The user data returned on SAX callbacks (possibly NULL)</td></tr><tr><td><spanclass="term"><i><tt>depth</tt></i>:</span></td><td>Used for loop detection, use 0</td></tr><tr><td><spanclass="term"><i><tt>string</tt></i>:</span></td><td>the input string in UTF8 or ISO-Latin (zero terminated)</td></tr><tr><td><spanclass="term"><i><tt>lst</tt></i>:</span></td><td>the return value for the set of parsed nodes</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the chunk is well balanced, -1 in case of args problem and the parser error code otherwise</td></tr></tbody></table></div><h3><aname="xmlRecoverDoc"id="xmlRecoverDoc"></a>Function: xmlRecoverDoc</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlRecoverDoc (<ahref="libxml-tree.html#xmlChar">xmlChar</a> * cur)<br/>
</pre><p>parse an XML in-memory document and build a tree. In the case the document is not Well Formed, a tree is built anyway</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>a pointer to an array of <ahref="libxml-tree.html#xmlChar">xmlChar</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the resulting document tree</td></tr></tbody></table></div><h3><aname="xmlCleanupParser"id="xmlCleanupParser"></a>Function: xmlCleanupParser</h3><preclass="programlisting">void xmlCleanupParser (void)<br/>
</pre><p>Cleanup function for the XML library. It tries to reclaim all parsing related global memory allocated for the library processing. It doesn't deallocate any document related memory. Calling this function should not prevent reusing the library but one should call xmlCleanupParser() only when the process has finished using the library or XML document built with it.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>str1</tt></i>:</span></td><td>the first <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>str2</tt></i>:</span></td><td>the second <ahref="libxml-tree.html#xmlChar">xmlChar</a> *</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the integer result of the comparison</td></tr></tbody></table></div><h3><aname="xmlCtxtResetPush"id="xmlCtxtResetPush"></a>Function: xmlCtxtResetPush</h3><preclass="programlisting">int xmlCtxtResetPush (<ahref="libxml-tree.html#xmlParserCtxtPtr">xmlParserCtxtPtr</a> ctxt, <br/> const char * chunk, <br/> int size, <br/> const char * filename, <br/> const char * encoding)<br/>
</pre><p>Reset a push parser context</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>an XML parser context</td></tr><tr><td><spanclass="term"><i><tt>chunk</tt></i>:</span></td><td>a pointer to an array of chars</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>number of chars in the array</td></tr><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>an optional file name or URI</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the document encoding, or NULL</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of success and 1 in case of error</td></tr></tbody></table></div>
Is this document tagged standalone?
Called when the document start being processed.
<h3><aname="XML_SKIP_IDS"id="XML_SKIP_IDS"></a>Macro: XML_SKIP_IDS</h3><pre>#define XML_SKIP_IDS</pre><p>Bit in the loadsubset context field to tell to not do ID/REFs registration. Used to initialize <ahref="libxml-globals.html#xmlLoadExtDtdDefaultValue">xmlLoadExtDtdDefaultValue</a> in some special cases.</p>
</pre><p>Parse an external general entity An external general parsed entity is well-formed if it matches the production labeled extParsedEnt. [78] extParsedEnt ::= TextDecl? content</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document the chunk pertains to</td></tr><tr><td><spanclass="term"><i><tt>sax</tt></i>:</span></td><td>the SAX handler bloc (possibly NULL)</td></tr><tr><td><spanclass="term"><i><tt>user_data</tt></i>:</span></td><td>The user data returned on SAX callbacks (possibly NULL)</td></tr><tr><td><spanclass="term"><i><tt>depth</tt></i>:</span></td><td>Used for loop detection, use 0</td></tr><tr><td><spanclass="term"><i><tt>URL</tt></i>:</span></td><td>the URL for the entity to load</td></tr><tr><td><spanclass="term"><i><tt>ID</tt></i>:</span></td><td>the System ID for the entity to load</td></tr><tr><td><spanclass="term"><i><tt>lst</tt></i>:</span></td><td>the return value for the set of parsed nodes</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the entity is well formed, -1 in case of args problem and the parser error code otherwise</td></tr></tbody></table></div>
What to do when a notation declaration has been parsed.