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!
Только зарегистрированные пользователи имеют доступ к сервису!
Для получения аккаунта, обратитесь к администратору.
<preclass="programlisting">unsigned long <ahref="#xmlChildElementCount">xmlChildElementCount</a> (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> parent)</pre>
<h3><aname="LIBXML2_NEW_BUFFER"id="LIBXML2_NEW_BUFFER"></a>Macro: LIBXML2_NEW_BUFFER</h3><pre>#define LIBXML2_NEW_BUFFER</pre><p>Macro used to express that the API use the new buffers for <ahref="libxml-tree.html#xmlParserInputBuffer">xmlParserInputBuffer</a> and xmlOutputBuffer. The change was introduced in 2.9.0.</p>
<h3><aname="XML_GET_CONTENT"id="XML_GET_CONTENT"></a>Macro: XML_GET_CONTENT</h3><pre>#define XML_GET_CONTENT</pre><p>Macro to extract the content pointer of a node.</p>
<h3><aname="XML_GET_LINE"id="XML_GET_LINE"></a>Macro: XML_GET_LINE</h3><pre>#define XML_GET_LINE</pre><p>Macro to extract the line number of an element node.</p>
<h3><aname="XML_XML_ID"id="XML_XML_ID"></a>Macro: XML_XML_ID</h3><pre>#define XML_XML_ID</pre><p>This is the name for the special xml:id <ahref="libxml-SAX.html#attribute">attribute</a></p>
<h3><aname="XML_XML_NAMESPACE"id="XML_XML_NAMESPACE"></a>Macro: XML_XML_NAMESPACE</h3><pre>#define XML_XML_NAMESPACE</pre><p>This is the namespace for the special xml: prefix predefined in the XML Namespace specification.</p>
<h3><aname="xmlChildrenNode"id="xmlChildrenNode"></a>Macro: xmlChildrenNode</h3><pre>#define xmlChildrenNode</pre><p>Macro for compatibility naming layer with libxml1. Maps to "children."</p>
<h3><aname="xmlRootNode"id="xmlRootNode"></a>Macro: xmlRootNode</h3><pre>#define xmlRootNode</pre><p>Macro for compatibility naming layer with libxml1. Maps to "children".</p>
</pre><p>Add a new node to @parent, at the end of the child (or property) list merging adjacent TEXT nodes (in which case @cur is freed) If the new node is ATTRIBUTE, it is added into properties instead of children. If there is an <ahref="libxml-SAX.html#attribute">attribute</a> with equal name, it is first destroyed.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>parent</tt></i>:</span></td><td>the parent node</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the child node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the child or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlAddChildList"id="xmlAddChildList"></a>Function: xmlAddChildList</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlAddChildList (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> parent, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur)<br/>
</pre><p>Add a list of node at the end of the child list of the parent merging adjacent TEXT nodes (@cur may be freed)</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>parent</tt></i>:</span></td><td>the parent node</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the first node in the list</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the last child or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlAddNextSibling"id="xmlAddNextSibling"></a>Function: xmlAddNextSibling</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlAddNextSibling (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem)<br/>
</pre><p>Add a new node @elem as the next sibling of @cur If the new node was already inserted in a document it is first unlinked from its existing context. As a result of text merging @elem may be freed. If the new node is ATTRIBUTE, it is added into properties instead of children. If there is an <ahref="libxml-SAX.html#attribute">attribute</a> with equal name, it is first destroyed.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the child node</td></tr><tr><td><spanclass="term"><i><tt>elem</tt></i>:</span></td><td>the new node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new node or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlAddPrevSibling"id="xmlAddPrevSibling"></a>Function: xmlAddPrevSibling</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlAddPrevSibling (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem)<br/>
</pre><p>Add a new node @elem as the previous sibling of @cur merging adjacent TEXT nodes (@elem may be freed) If the new node was already inserted in a document it is first unlinked from its existing context. If the new node is ATTRIBUTE, it is added into properties instead of children. If there is an <ahref="libxml-SAX.html#attribute">attribute</a> with equal name, it is first destroyed.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the child node</td></tr><tr><td><spanclass="term"><i><tt>elem</tt></i>:</span></td><td>the new node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new node or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlAddSibling"id="xmlAddSibling"></a>Function: xmlAddSibling</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlAddSibling (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem)<br/>
</pre><p>Add a new element @elem to the list of siblings of @cur merging adjacent TEXT nodes (@elem may be freed) If the new element was already inserted in a document it is first unlinked from its existing context.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the child node</td></tr><tr><td><spanclass="term"><i><tt>elem</tt></i>:</span></td><td>the new node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new element or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlAttrSerializeTxtContent"id="xmlAttrSerializeTxtContent"></a>Function: xmlAttrSerializeTxtContent</h3><preclass="programlisting">void xmlAttrSerializeTxtContent (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> attr, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * string)<br/>
</pre><p>Serialize text <ahref="libxml-SAX.html#attribute">attribute</a> values to an xml simple buffer</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the end of the internal content or NULL in case of error</td></tr></tbody></table></div><h3><aname="xmlBufGetNodeContent"id="xmlBufGetNodeContent"></a>Function: xmlBufGetNodeContent</h3><preclass="programlisting">int xmlBufGetNodeContent (<ahref="libxml-tree.html#xmlBufPtr">xmlBufPtr</a> buf, <br/> const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * cur)<br/>
</pre><p>Read the value of a node @cur, this can be either the text carried directly by this node if it's a TEXT node or the aggregate string of the values carried by this node child's (TEXT and ENTITY_REF). Entity references are substituted. Fills up the buffer @buf with this value</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>a buffer <ahref="libxml-tree.html#xmlBufPtr">xmlBufPtr</a></td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being read</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><h3><aname="xmlBufNodeDump"id="xmlBufNodeDump"></a>Function: xmlBufNodeDump</h3><preclass="programlisting">size_t xmlBufNodeDump (<ahref="libxml-tree.html#xmlBufPtr">xmlBufPtr</a> buf, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/> int level, <br/> int format)<br/>
</pre><p>Dump an XML node, recursive behaviour,children are printed too. Note that @format = 1 provide node indenting only if <ahref="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a> = 1 or xmlKeepBlanksDefault(0) was called</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the XML buffer output</td></tr><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the current node</td></tr><tr><td><spanclass="term"><i><tt>level</tt></i>:</span></td><td>the imbrication level for indenting</td></tr><tr><td><spanclass="term"><i><tt>format</tt></i>:</span></td><td>is formatting allowed</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written to the buffer, in case of error 0 is returned or @buf stores the error</td></tr></tbody></table></div><h3><aname="xmlBufShrink"id="xmlBufShrink"></a>Function: xmlBufShrink</h3><preclass="programlisting">size_t xmlBufShrink (<ahref="libxml-tree.html#xmlBufPtr">xmlBufPtr</a> buf, <br/> size_t len)<br/>
</pre><p>Remove the beginning of an XML buffer. NOTE that this routine behaviour differs from xmlBufferShrink() as it will return 0 on error instead of -1 due to size_t being used as the return type.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer to dump</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the number of <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> to remove</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of byte removed or 0 in case of failure</td></tr></tbody></table></div><h3><aname="xmlBufUse"id="xmlBufUse"></a>Function: xmlBufUse</h3><preclass="programlisting">size_t xmlBufUse (const <ahref="libxml-tree.html#xmlBufPtr">xmlBufPtr</a> buf)<br/>
</pre><p>Function to get the length of a buffer</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the length of data in the internal content</td></tr></tbody></table></div><h3><aname="xmlBufferAdd"id="xmlBufferAdd"></a>Function: xmlBufferAdd</h3><preclass="programlisting">int xmlBufferAdd (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * str, <br/> int len)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer to dump</td></tr><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the #xmlChar string</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the number of #xmlChar to add</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 successful, a positive error code number otherwise and -1 in case of internal or API error.</td></tr></tbody></table></div><h3><aname="xmlBufferAddHead"id="xmlBufferAddHead"></a>Function: xmlBufferAddHead</h3><preclass="programlisting">int xmlBufferAddHead (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * str, <br/> int len)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer</td></tr><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the #xmlChar string</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the number of #xmlChar to add</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 successful, a positive error code number otherwise and -1 in case of internal or API error.</td></tr></tbody></table></div><h3><aname="xmlBufferCCat"id="xmlBufferCCat"></a>Function: xmlBufferCCat</h3><preclass="programlisting">int xmlBufferCCat (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/> const char * str)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer to dump</td></tr><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the C char string</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 successful, a positive error code number otherwise and -1 in case of internal or API error.</td></tr></tbody></table></div><h3><aname="xmlBufferCat"id="xmlBufferCat"></a>Function: xmlBufferCat</h3><preclass="programlisting">int xmlBufferCat (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * str)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer to add to</td></tr><tr><td><spanclass="term"><i><tt>str</tt></i>:</span></td><td>the #xmlChar string</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 successful, a positive error code number otherwise and -1 in case of internal or API error.</td></tr></tbody></table></div><h3><aname="xmlBufferContent"id="xmlBufferContent"></a>Function: xmlBufferContent</h3><preclass="programlisting">const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlBufferContent (const <ahref="libxml-tree.html#xmlBuffer">xmlBuffer</a> * buf)<br/>
</pre><p>routine to create an XML buffer from an immutable memory area. The area won't be modified nor copied, and is expected to be present until the end of the buffer lifetime.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>mem</tt></i>:</span></td><td>the memory area</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the size in byte</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new structure.</td></tr></tbody></table></div><h3><aname="xmlBufferDetach"id="xmlBufferDetach"></a>Function: xmlBufferDetach</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlBufferDetach (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf)<br/>
</pre><p>Remove the string contained in a buffer and gie it back to the caller. The buffer is reset to an empty content. This doesn't work with immutable buffers as they can't be reset.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the previous string contained by the buffer.</td></tr></tbody></table></div><h3><aname="xmlBufferDump"id="xmlBufferDump"></a>Function: xmlBufferDump</h3><preclass="programlisting">int xmlBufferDump (FILE * file, <br/><ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>file</tt></i>:</span></td><td>the file output</td></tr><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer to dump</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of #xmlChar written</td></tr></tbody></table></div><h3><aname="xmlBufferEmpty"id="xmlBufferEmpty"></a>Function: xmlBufferEmpty</h3><preclass="programlisting">void xmlBufferEmpty (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the minimum free size to allocate</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new available space or -1 in case of error</td></tr></tbody></table></div><h3><aname="xmlBufferLength"id="xmlBufferLength"></a>Function: xmlBufferLength</h3><preclass="programlisting">int xmlBufferLength (const <ahref="libxml-tree.html#xmlBuffer">xmlBuffer</a> * buf)<br/>
</pre><p>Function to get the length of a buffer</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the length of data in the internal content</td></tr></tbody></table></div><h3><aname="xmlBufferResize"id="xmlBufferResize"></a>Function: xmlBufferResize</h3><preclass="programlisting">int xmlBufferResize (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/> unsigned int size)<br/>
</pre><p>Resize a buffer to accommodate minimum size of @size.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer to resize</td></tr><tr><td><spanclass="term"><i><tt>size</tt></i>:</span></td><td>the desired size</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 in case of problems, 1 otherwise</td></tr></tbody></table></div><h3><aname="xmlBufferSetAllocationScheme"id="xmlBufferSetAllocationScheme"></a>Function: xmlBufferSetAllocationScheme</h3><preclass="programlisting">void xmlBufferSetAllocationScheme (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/><ahref="libxml-tree.html#xmlBufferAllocationScheme">xmlBufferAllocationScheme</a> scheme)<br/>
</pre><p>Sets the allocation scheme for this buffer</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer to tune</td></tr><tr><td><spanclass="term"><i><tt>scheme</tt></i>:</span></td><td>allocation scheme to use</td></tr></tbody></table></div><h3><aname="xmlBufferShrink"id="xmlBufferShrink"></a>Function: xmlBufferShrink</h3><preclass="programlisting">int xmlBufferShrink (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/> unsigned int len)<br/>
</pre><p>Remove the beginning of an XML buffer.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the buffer to dump</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the number of <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> to remove</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of #xmlChar removed, or -1 in case of failure.</td></tr></tbody></table></div><h3><aname="xmlBufferWriteCHAR"id="xmlBufferWriteCHAR"></a>Function: xmlBufferWriteCHAR</h3><preclass="programlisting">void xmlBufferWriteCHAR (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * string)<br/>
</pre><p>routine which manage and grows an output buffer. This one writes a quoted or double quoted #xmlChar string, checking first if it holds quote or double-quotes internally</p>
</pre><p>Builds the QName @prefix:@ncname in @memory if there is enough space and prefix is not NULL nor empty, otherwise allocate a new string. If prefix is NULL or empty it returns ncname.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ncname</tt></i>:</span></td><td>the Name</td></tr><tr><td><spanclass="term"><i><tt>prefix</tt></i>:</span></td><td>the prefix</td></tr><tr><td><spanclass="term"><i><tt>memory</tt></i>:</span></td><td>preallocated memory</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>preallocated memory length</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new string which must be freed by the caller if different from @memory and @ncname or NULL in case of error</td></tr></tbody></table></div><h3><aname="xmlChildElementCount"id="xmlChildElementCount"></a>Function: xmlChildElementCount</h3><preclass="programlisting">unsigned long xmlChildElementCount (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> parent)<br/>
</pre><p>Finds the current number of child nodes of that element which are element nodes. Note the handling of entities references is different than in the W3C DOM element traversal spec since we don't have back <ahref="libxml-SAX.html#reference">reference</a> from entities content to entities references.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>parent</tt></i>:</span></td><td>the parent node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the count of element child or 0 if not available</td></tr></tbody></table></div><h3><aname="xmlCopyDoc"id="xmlCopyDoc"></a>Function: xmlCopyDoc</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlCopyDoc (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> int recursive)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>recursive</tt></i>:</span></td><td>if not zero do a recursive copy.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlDocPtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCopyDtd"id="xmlCopyDtd"></a>Function: xmlCopyDtd</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> xmlCopyDtd (<ahref="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> dtd)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>dtd</tt></i>:</span></td><td>the dtd</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlDtdPtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCopyNamespace"id="xmlCopyNamespace"></a>Function: xmlCopyNamespace</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> xmlCopyNamespace (<ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> cur)<br/>
</pre><p>Do a copy of the namespace.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the namespace</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlNsPtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCopyNamespaceList"id="xmlCopyNamespaceList"></a>Function: xmlCopyNamespaceList</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> xmlCopyNamespaceList (<ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> cur)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the first namespace</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlNsPtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCopyNode"id="xmlCopyNode"></a>Function: xmlCopyNode</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlCopyNode (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/> int extended)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>extended</tt></i>:</span></td><td>if 1 do a recursive copy (properties, namespaces and children when applicable) if 2 copy properties and namespaces (when applicable)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlNodePtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCopyNodeList"id="xmlCopyNodeList"></a>Function: xmlCopyNodeList</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlCopyNodeList (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the first node in the list.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlNodePtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCopyProp"id="xmlCopyProp"></a>Function: xmlCopyProp</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlCopyProp (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> target, <br/><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> cur)<br/>
</pre><p>Do a copy of the attribute.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>target</tt></i>:</span></td><td>the element where the <ahref="libxml-SAX.html#attribute">attribute</a> will be grafted</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlAttrPtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCopyPropList"id="xmlCopyPropList"></a>Function: xmlCopyPropList</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlCopyPropList (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> target, <br/><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> cur)<br/>
</pre><p>Do a copy of an <ahref="libxml-SAX.html#attribute">attribute</a> list.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>target</tt></i>:</span></td><td>the element where the attributes will be grafted</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the first <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlAttrPtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlCreateIntSubset"id="xmlCreateIntSubset"></a>Function: xmlCreateIntSubset</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> xmlCreateIntSubset (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * ExternalID, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * SystemID)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document pointer</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the DTD name</td></tr><tr><td><spanclass="term"><i><tt>ExternalID</tt></i>:</span></td><td>the external (PUBLIC) ID</td></tr><tr><td><spanclass="term"><i><tt>SystemID</tt></i>:</span></td><td>the system ID</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new DTD structure</td></tr></tbody></table></div><h3><aname="xmlDOMWrapAcquireNsFunction"id="xmlDOMWrapAcquireNsFunction"></a>Function type: xmlDOMWrapAcquireNsFunction</h3><preclass="programlisting">Function type: xmlDOMWrapAcquireNsFunction
</pre><p>A function called to acquire namespaces (xmlNs) from the wrapper.</p><divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>a DOM wrapper context</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the context node (element or attribute)</td></tr><tr><td><spanclass="term"><i><tt>nsName</tt></i>:</span></td><td>the requested namespace name</td></tr><tr><td><spanclass="term"><i><tt>nsPrefix</tt></i>:</span></td><td>the requested namespace prefix</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>an <ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> or NULL in case of an error.</td></tr></tbody></table></div><br/>
</pre><p>References of out-of scope ns-decls are remapped to point to @destDoc: 1) If @destParent is given, then nsDef entries on element-nodes are used 2) If *no* @destParent is given, then @destDoc->oldNs entries are used This is the case when you have an unlinked node and just want to move it to the context of If @destParent is given, it ensures that the tree is namespace wellformed by creating additional ns-decls where needed. Note that, since prefixes of already existent ns-decls can be shadowed by this process, it could break QNames in <ahref="libxml-SAX.html#attribute">attribute</a> values or element content. NOTE: This function was not intensively tested.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>the optional context for custom processing</td></tr><tr><td><spanclass="term"><i><tt>sourceDoc</tt></i>:</span></td><td>the optional sourceDoc</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node to start with</td></tr><tr><td><spanclass="term"><i><tt>destDoc</tt></i>:</span></td><td>the destination doc</td></tr><tr><td><spanclass="term"><i><tt>destParent</tt></i>:</span></td><td>the optional new parent of @node in @destDoc</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>option flags</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the operation succeeded, 1 if a node of unsupported type was given, 2 if a node of not yet supported type was given and -1 on API/internal errors.</td></tr></tbody></table></div><h3><aname="xmlDOMWrapCloneNode"id="xmlDOMWrapCloneNode"></a>Function: xmlDOMWrapCloneNode</h3><preclass="programlisting">int xmlDOMWrapCloneNode (<ahref="libxml-tree.html#xmlDOMWrapCtxtPtr">xmlDOMWrapCtxtPtr</a> ctxt, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> sourceDoc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> * resNode, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> destDoc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> destParent, <br/> int deep, <br/> int options)<br/>
</pre><p>References of out-of scope ns-decls are remapped to point to @destDoc: 1) If @destParent is given, then nsDef entries on element-nodes are used 2) If *no* @destParent is given, then @destDoc->oldNs entries are used. This is the case when you don't know already where the cloned branch will be added to. If @destParent is given, it ensures that the tree is namespace wellformed by creating additional ns-decls where needed. Note that, since prefixes of already existent ns-decls can be shadowed by this process, it could break QNames in <ahref="libxml-SAX.html#attribute">attribute</a> values or element content. TODO: 1) What to do with XInclude? Currently this returns an error for XInclude.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>the optional context for custom processing</td></tr><tr><td><spanclass="term"><i><tt>sourceDoc</tt></i>:</span></td><td>the optional sourceDoc</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node to start with</td></tr><tr><td><spanclass="term"><i><tt>resNode</tt></i>:</span></td><td>the clone of the given @node</td></tr><tr><td><spanclass="term"><i><tt>destDoc</tt></i>:</span></td><td>the destination doc</td></tr><tr><td><spanclass="term"><i><tt>destParent</tt></i>:</span></td><td>the optional new parent of @node in @destDoc</td></tr><tr><td><spanclass="term"><i><tt>deep</tt></i>:</span></td><td>descend into child if set</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>option flags</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if the operation succeeded, 1 if a node of unsupported (or not yet supported) type was given, -1 on API/internal errors.</td></tr></tbody></table></div><h3><aname="xmlDOMWrapFreeCtxt"id="xmlDOMWrapFreeCtxt"></a>Function: xmlDOMWrapFreeCtxt</h3><preclass="programlisting">void xmlDOMWrapFreeCtxt (<ahref="libxml-tree.html#xmlDOMWrapCtxtPtr">xmlDOMWrapCtxtPtr</a> ctxt)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-tree.html#xmlDOMWrapCtxtPtr">xmlDOMWrapCtxtPtr</a> or NULL in case of an internal error.</td></tr></tbody></table></div><h3><aname="xmlDOMWrapReconcileNamespaces"id="xmlDOMWrapReconcileNamespaces"></a>Function: xmlDOMWrapReconcileNamespaces</h3><preclass="programlisting">int xmlDOMWrapReconcileNamespaces (<ahref="libxml-tree.html#xmlDOMWrapCtxtPtr">xmlDOMWrapCtxtPtr</a> ctxt, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> elem, <br/> int options)<br/>
</pre><p>Ensures that ns-references point to ns-decls hold on element-nodes. Ensures that the tree is namespace wellformed by creating additional ns-decls where needed. Note that, since prefixes of already existent ns-decls can be shadowed by this process, it could break QNames in <ahref="libxml-SAX.html#attribute">attribute</a> values or element content. NOTE: This function was not intensively tested.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>DOM wrapper context, unused at the moment</td></tr><tr><td><spanclass="term"><i><tt>elem</tt></i>:</span></td><td>the element-node</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>option flags</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if succeeded, -1 otherwise and on API/internal errors.</td></tr></tbody></table></div><h3><aname="xmlDOMWrapRemoveNode"id="xmlDOMWrapRemoveNode"></a>Function: xmlDOMWrapRemoveNode</h3><preclass="programlisting">int xmlDOMWrapRemoveNode (<ahref="libxml-tree.html#xmlDOMWrapCtxtPtr">xmlDOMWrapCtxtPtr</a> ctxt, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/> int options)<br/>
</pre><p>Unlinks the given node from its owner. This will substitute ns-references to node->nsDef for ns-references to doc->oldNs, thus ensuring the removed branch to be autark wrt ns-references. NOTE: This function was not intensively tested.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ctxt</tt></i>:</span></td><td>a DOM wrapper context</td></tr><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the doc</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node to be removed.</td></tr><tr><td><spanclass="term"><i><tt>options</tt></i>:</span></td><td>set of options, unused at the moment</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 on success, 1 if the node is not supported, -1 on API and internal errors.</td></tr></tbody></table></div><h3><aname="xmlDocCopyNode"id="xmlDocCopyNode"></a>Function: xmlDocCopyNode</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlDocCopyNode (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> int extended)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>extended</tt></i>:</span></td><td>if 1 do a recursive copy (properties, namespaces and children when applicable) if 2 copy properties and namespaces (when applicable)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlNodePtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlDocCopyNodeList"id="xmlDocCopyNodeList"></a>Function: xmlDocCopyNodeList</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlDocCopyNodeList (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node)<br/>
</pre><p>Do a recursive copy of the node list.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the target document</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the first node in the list.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlNodePtr, or NULL in case of error.</td></tr></tbody></table></div><h3><aname="xmlDocDump"id="xmlDocDump"></a>Function: xmlDocDump</h3><preclass="programlisting">int xmlDocDump (FILE * f, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>f</tt></i>:</span></td><td>the FILE*</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written or -1 in case of failure.</td></tr></tbody></table></div><h3><aname="xmlDocDumpFormatMemory"id="xmlDocDumpFormatMemory"></a>Function: xmlDocDumpFormatMemory</h3><preclass="programlisting">void xmlDocDumpFormatMemory (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur, <br/><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> ** mem, <br/> int * size, <br/> int format)<br/>
</pre><p>Dump an XML document in memory and return the #xmlChar * and it's size. It's up to the caller to free the memory with xmlFree(). Note that @format = 1 provide node indenting only if <ahref="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a> = 1 or xmlKeepBlanksDefault(0) was called</p>
</pre><p>Dump the current DOM tree into memory using the character encoding specified by the caller. Note it is up to the caller of this function to free the allocated memory with xmlFree(). Note that @format = 1 provide node indenting only if <ahref="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a> = 1 or xmlKeepBlanksDefault(0) was called</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>out_doc</tt></i>:</span></td><td>Document to generate XML text from</td></tr><tr><td><spanclass="term"><i><tt>doc_txt_ptr</tt></i>:</span></td><td>Memory pointer for allocated XML text</td></tr><tr><td><spanclass="term"><i><tt>doc_txt_len</tt></i>:</span></td><td>Length of the generated XML text</td></tr><tr><td><spanclass="term"><i><tt>txt_encoding</tt></i>:</span></td><td>Character encoding to use when generating XML text</td></tr><tr><td><spanclass="term"><i><tt>format</tt></i>:</span></td><td>should formatting spaces been added</td></tr></tbody></table></div><h3><aname="xmlDocDumpMemory"id="xmlDocDumpMemory"></a>Function: xmlDocDumpMemory</h3><preclass="programlisting">void xmlDocDumpMemory (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur, <br/><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> ** mem, <br/> int * size)<br/>
</pre><p>Dump an XML document in memory and return the #xmlChar * and it's size in bytes. It's up to the caller to free the memory with xmlFree(). The resulting byte array is zero terminated, though the last 0 is not included in the returned size.</p>
</pre><p>Dump the current DOM tree into memory using the character encoding specified by the caller. Note it is up to the caller of this function to free the allocated memory with xmlFree().</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>out_doc</tt></i>:</span></td><td>Document to generate XML text from</td></tr><tr><td><spanclass="term"><i><tt>doc_txt_ptr</tt></i>:</span></td><td>Memory pointer for allocated XML text</td></tr><tr><td><spanclass="term"><i><tt>doc_txt_len</tt></i>:</span></td><td>Length of the generated XML text</td></tr><tr><td><spanclass="term"><i><tt>txt_encoding</tt></i>:</span></td><td>Character encoding to use when generating XML text</td></tr></tbody></table></div><h3><aname="xmlDocFormatDump"id="xmlDocFormatDump"></a>Function: xmlDocFormatDump</h3><preclass="programlisting">int xmlDocFormatDump (FILE * f, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur, <br/> int format)<br/>
</pre><p>Dump an XML document to an open FILE.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>f</tt></i>:</span></td><td>the FILE*</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>format</tt></i>:</span></td><td>should formatting spaces been added</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written or -1 in case of failure. Note that @format = 1 provide node indenting only if <ahref="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a> = 1 or xmlKeepBlanksDefault(0) was called</td></tr></tbody></table></div><h3><aname="xmlDocGetRootElement"id="xmlDocGetRootElement"></a>Function: xmlDocGetRootElement</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlDocGetRootElement (const <ahref="libxml-tree.html#xmlDoc">xmlDoc</a> * doc)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the #xmlNodePtr for the root or NULL</td></tr></tbody></table></div><h3><aname="xmlDocSetRootElement"id="xmlDocSetRootElement"></a>Function: xmlDocSetRootElement</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlDocSetRootElement (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> root)<br/>
</pre><p>Set the root element of the document (doc->children is a list containing possibly comments, PIs, etc ...).</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>root</tt></i>:</span></td><td>the new document root element, if root is NULL no action is taken, to remove a node from a document use xmlUnlinkNode(root) instead.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the old root element if any was found, NULL if root was NULL</td></tr></tbody></table></div><h3><aname="xmlElemDump"id="xmlElemDump"></a>Function: xmlElemDump</h3><preclass="programlisting">void xmlElemDump (FILE * f, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>f</tt></i>:</span></td><td>the FILE * for the output</td></tr><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the current node</td></tr></tbody></table></div><h3><aname="xmlFirstElementChild"id="xmlFirstElementChild"></a>Function: xmlFirstElementChild</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlFirstElementChild (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> parent)<br/>
</pre><p>Finds the first child node of that element which is a Element node Note the handling of entities references is different than in the W3C DOM element traversal spec since we don't have back <ahref="libxml-SAX.html#reference">reference</a> from entities content to entities references.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>parent</tt></i>:</span></td><td>the parent node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the first element child or NULL if not available</td></tr></tbody></table></div><h3><aname="xmlFreeDoc"id="xmlFreeDoc"></a>Function: xmlFreeDoc</h3><preclass="programlisting">void xmlFreeDoc (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur)<br/>
</pre><p>Free up all the structures used by a document, tree included.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>pointer to the document</td></tr></tbody></table></div><h3><aname="xmlFreeDtd"id="xmlFreeDtd"></a>Function: xmlFreeDtd</h3><preclass="programlisting">void xmlFreeDtd (<ahref="libxml-tree.html#xmlDtdPtr">xmlDtdPtr</a> cur)<br/>
</pre><p>Free a DTD structure.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the DTD structure to free up</td></tr></tbody></table></div><h3><aname="xmlFreeNode"id="xmlFreeNode"></a>Function: xmlFreeNode</h3><preclass="programlisting">void xmlFreeNode (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur)<br/>
</pre><p>Free a node, this is a recursive behaviour, all the children are freed too. This doesn't unlink the child from the list, use xmlUnlinkNode() first.</p>
</pre><p>Free a node and all its siblings, this is a recursive behaviour, all the children are freed too.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the first node in the list</td></tr></tbody></table></div><h3><aname="xmlFreeNs"id="xmlFreeNs"></a>Function: xmlFreeNs</h3><preclass="programlisting">void xmlFreeNs (<ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> cur)<br/>
</pre><p>Free a property and all its siblings, all the children are freed too.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the first property in the list</td></tr></tbody></table></div><h3><aname="xmlGetBufferAllocationScheme"id="xmlGetBufferAllocationScheme"></a>Function: xmlGetBufferAllocationScheme</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlBufferAllocationScheme">xmlBufferAllocationScheme</a> xmlGetBufferAllocationScheme (void)<br/>
</pre><p>Types are <ahref="libxml-tree.html#XML_BUFFER_ALLOC_EXACT">XML_BUFFER_ALLOC_EXACT</a> - use exact sizes, keeps memory usage down <ahref="libxml-tree.html#XML_BUFFER_ALLOC_DOUBLEIT">XML_BUFFER_ALLOC_DOUBLEIT</a> - double buffer when extra needed, improves performance <ahref="libxml-tree.html#XML_BUFFER_ALLOC_HYBRID">XML_BUFFER_ALLOC_HYBRID</a> - use exact sizes on small strings to keep memory usage tight in normal usage, and doubleit on large strings to avoid pathological performance.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document pointer</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the DTD structure or NULL if not found</td></tr></tbody></table></div><h3><aname="xmlGetLastChild"id="xmlGetLastChild"></a>Function: xmlGetLastChild</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlGetLastChild (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * parent)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>parent</tt></i>:</span></td><td>the parent node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the last child or NULL if none.</td></tr></tbody></table></div><h3><aname="xmlGetLineNo"id="xmlGetLineNo"></a>Function: xmlGetLineNo</h3><preclass="programlisting">long xmlGetLineNo (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node)<br/>
</pre><p>Get line number of @node. Try to override the limitation of lines being store in 16 bits ints if <ahref="libxml-parser.html#XML_PARSE_BIG_LINES">XML_PARSE_BIG_LINES</a> parser option was used</p>
</pre><p>Search and get the value of an <ahref="libxml-SAX.html#attribute">attribute</a> associated to a node This does the entity substitution. This function looks in DTD <ahref="libxml-SAX.html#attribute">attribute</a> declaration for #FIXED or default declaration values unless DTD use has been turned off. This function is similar to <ahref="libxml-tree.html#xmlGetProp">xmlGetProp</a> except it will accept only an <ahref="libxml-SAX.html#attribute">attribute</a> in no namespace.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> value or NULL if not found. It's up to the caller to free the memory with xmlFree().</td></tr></tbody></table></div><h3><aname="xmlGetNodePath"id="xmlGetNodePath"></a>Function: xmlGetNodePath</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlGetNodePath (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>a node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the new path or NULL in case of error. The caller must free the returned string</td></tr></tbody></table></div><h3><aname="xmlGetNsList"id="xmlGetNsList"></a>Function: xmlGetNsList</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> * xmlGetNsList (const <ahref="libxml-tree.html#xmlDoc">xmlDoc</a> * doc, <br/> const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the current node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>an NULL terminated array of all the #xmlNsPtr found that need to be freed by the caller or NULL if no namespace if defined</td></tr></tbody></table></div><h3><aname="xmlGetNsProp"id="xmlGetNsProp"></a>Function: xmlGetNsProp</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlGetNsProp (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * nameSpace)<br/>
</pre><p>Search and get the value of an <ahref="libxml-SAX.html#attribute">attribute</a> associated to a node This <ahref="libxml-SAX.html#attribute">attribute</a> has to be anchored in the namespace specified. This does the entity substitution. This function looks in DTD <ahref="libxml-SAX.html#attribute">attribute</a> declaration for #FIXED or default declaration values unless DTD use has been turned off.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> name</td></tr><tr><td><spanclass="term"><i><tt>nameSpace</tt></i>:</span></td><td>the URI of the namespace</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> value or NULL if not found. It's up to the caller to free the memory with xmlFree().</td></tr></tbody></table></div><h3><aname="xmlGetProp"id="xmlGetProp"></a>Function: xmlGetProp</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlGetProp (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name)<br/>
</pre><p>Search and get the value of an <ahref="libxml-SAX.html#attribute">attribute</a> associated to a node This does the entity substitution. This function looks in DTD <ahref="libxml-SAX.html#attribute">attribute</a> declaration for #FIXED or default declaration values unless DTD use has been turned off. NOTE: this function acts independently of namespaces associated to the attribute. Use xmlGetNsProp() or xmlGetNoNsProp() for namespace aware processing.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> value or NULL if not found. It's up to the caller to free the memory with xmlFree().</td></tr></tbody></table></div><h3><aname="xmlHasNsProp"id="xmlHasNsProp"></a>Function: xmlHasNsProp</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlHasNsProp (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * nameSpace)<br/>
</pre><p>Search for an <ahref="libxml-SAX.html#attribute">attribute</a> associated to a node This <ahref="libxml-SAX.html#attribute">attribute</a> has to be anchored in the namespace specified. This does the entity substitution. This function looks in DTD <ahref="libxml-SAX.html#attribute">attribute</a> declaration for #FIXED or default declaration values unless DTD use has been turned off. Note that a namespace of NULL indicates to use the default namespace.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> name</td></tr><tr><td><spanclass="term"><i><tt>nameSpace</tt></i>:</span></td><td>the URI of the namespace</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> or the <ahref="libxml-SAX.html#attribute">attribute</a> declaration or NULL if neither was found.</td></tr></tbody></table></div><h3><aname="xmlHasProp"id="xmlHasProp"></a>Function: xmlHasProp</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlHasProp (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name)<br/>
</pre><p>Search an <ahref="libxml-SAX.html#attribute">attribute</a> associated to a node This function also looks in DTD <ahref="libxml-SAX.html#attribute">attribute</a> declaration for #FIXED or default declaration values unless DTD use has been turned off.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> or the <ahref="libxml-SAX.html#attribute">attribute</a> declaration or NULL if neither was found.</td></tr></tbody></table></div><h3><aname="xmlIsBlankNode"id="xmlIsBlankNode"></a>Function: xmlIsBlankNode</h3><preclass="programlisting">int xmlIsBlankNode (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>systemID</tt></i>:</span></td><td>the system identifier</td></tr><tr><td><spanclass="term"><i><tt>publicID</tt></i>:</span></td><td>the public identifier</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>1 if true, 0 if not and -1 in case of error</td></tr></tbody></table></div><h3><aname="xmlLastElementChild"id="xmlLastElementChild"></a>Function: xmlLastElementChild</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlLastElementChild (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> parent)<br/>
</pre><p>Finds the last child node of that element which is a Element node Note the handling of entities references is different than in the W3C DOM element traversal spec since we don't have back <ahref="libxml-SAX.html#reference">reference</a> from entities content to entities references.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>parent</tt></i>:</span></td><td>the parent node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the last element child or NULL if not available</td></tr></tbody></table></div><h3><aname="xmlNewCDataBlock"id="xmlNewCDataBlock"></a>Function: xmlNewCDataBlock</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewCDataBlock (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content, <br/> int len)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the CDATA block content content</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the length of the block</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewCharRef"id="xmlNewCharRef"></a>Function: xmlNewCharRef</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewCharRef (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name)<br/>
</pre><p>Creation of a new child element, added at the end of @parent children list. @ns and @content parameters are optional (NULL). If @ns is NULL, the newly created element inherits the namespace of @parent. If @content is non NULL, a child list containing the TEXTs and ENTITY_REFs node will be created. NOTE: @content is supposed to be a piece of XML CDATA, so it allows entity references. XML special chars must be escaped first by using xmlEncodeEntitiesReentrant(), or xmlNewTextChild() should be used.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>parent</tt></i>:</span></td><td>the parent node</td></tr><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>a namespace if any</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the name of the child</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the XML content of the child if any.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewComment"id="xmlNewComment"></a>Function: xmlNewComment</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewComment (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#comment">comment</a> content</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewDoc"id="xmlNewDoc"></a>Function: xmlNewDoc</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> xmlNewDoc (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * version)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>version</tt></i>:</span></td><td><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> string giving the version of XML "1.0"</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new document</td></tr></tbody></table></div><h3><aname="xmlNewDocComment"id="xmlNewDocComment"></a>Function: xmlNewDocComment</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewDocComment (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#comment">comment</a> content</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewDocFragment"id="xmlNewDocFragment"></a>Function: xmlNewDocFragment</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewDocFragment (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc)<br/>
</pre><p>Creation of a new node element within a document. @ns and @content are optional (NULL). NOTE: @content is supposed to be a piece of XML CDATA, so it allow entities references, but XML special chars need to be escaped first by using xmlEncodeEntitiesReentrant(). Use xmlNewDocRawNode() if you don't need entities support.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>namespace if any</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the node name</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the XML text content if any</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewDocNodeEatName"id="xmlNewDocNodeEatName"></a>Function: xmlNewDocNodeEatName</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewDocNodeEatName (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> ns, <br/><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
</pre><p>Creation of a new node element within a document. @ns and @content are optional (NULL). NOTE: @content is supposed to be a piece of XML CDATA, so it allow entities references, but XML special chars need to be escaped first by using xmlEncodeEntitiesReentrant(). Use xmlNewDocRawNode() if you don't need entities support.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>namespace if any</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the node name</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the XML text content if any</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewDocPI"id="xmlNewDocPI"></a>Function: xmlNewDocPI</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewDocPI (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
</pre><p>Creation of a processing instruction element.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the target document</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the processing instruction name</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the PI content</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewDocProp"id="xmlNewDocProp"></a>Function: xmlNewDocProp</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlNewDocProp (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the name of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr></tbody></table></div><h3><aname="xmlNewDocRawNode"id="xmlNewDocRawNode"></a>Function: xmlNewDocRawNode</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewDocRawNode (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> ns, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>namespace if any</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the node name</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the text content if any</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewDocText"id="xmlNewDocText"></a>Function: xmlNewDocText</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewDocText (const <ahref="libxml-tree.html#xmlDoc">xmlDoc</a> * doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the text content</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewDocTextLen"id="xmlNewDocTextLen"></a>Function: xmlNewDocTextLen</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewDocTextLen (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content, <br/> int len)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document carrying the namespace</td></tr><tr><td><spanclass="term"><i><tt>href</tt></i>:</span></td><td>the URI associated</td></tr><tr><td><spanclass="term"><i><tt>prefix</tt></i>:</span></td><td>the prefix for the namespace</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>NULL this functionality had been removed</td></tr></tbody></table></div><h3><aname="xmlNewNode"id="xmlNewNode"></a>Function: xmlNewNode</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewNode (<ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> ns, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>namespace if any</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the node name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object. Uses xmlStrdup() to make copy of @name.</td></tr></tbody></table></div><h3><aname="xmlNewNodeEatName"id="xmlNewNodeEatName"></a>Function: xmlNewNodeEatName</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewNodeEatName (<ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> ns, <br/><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>namespace if any</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the node name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object, with pointer @name as new node's name. Use xmlNewNode() if a copy of @name string is is needed as new node's name.</td></tr></tbody></table></div><h3><aname="xmlNewNs"id="xmlNewNs"></a>Function: xmlNewNs</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> xmlNewNs (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * href, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * prefix)<br/>
</pre><p>Creation of a new Namespace. This function will refuse to create a namespace with a similar prefix than an existing one present on this node. Note that for a default namespace, @prefix should be NULL. We use href==NULL in the case of an element creation where the namespace was not defined.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the element carrying the namespace</td></tr><tr><td><spanclass="term"><i><tt>href</tt></i>:</span></td><td>the URI associated</td></tr><tr><td><spanclass="term"><i><tt>prefix</tt></i>:</span></td><td>the prefix for the namespace</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new namespace pointer or NULL</td></tr></tbody></table></div><h3><aname="xmlNewNsProp"id="xmlNewNsProp"></a>Function: xmlNewNsProp</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlNewNsProp (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> ns, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the holding node</td></tr><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>the namespace</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the name of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr></tbody></table></div><h3><aname="xmlNewNsPropEatName"id="xmlNewNsPropEatName"></a>Function: xmlNewNsPropEatName</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> xmlNewNsPropEatName (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> ns, <br/><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the holding node</td></tr><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>the namespace</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the name of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr></tbody></table></div><h3><aname="xmlNewPI"id="xmlNewPI"></a>Function: xmlNewPI</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewPI (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the holding node</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the name of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr></tbody></table></div><h3><aname="xmlNewReference"id="xmlNewReference"></a>Function: xmlNewReference</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewReference (const <ahref="libxml-tree.html#xmlDoc">xmlDoc</a> * doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#reference">reference</a> name, or the <ahref="libxml-SAX.html#reference">reference</a> string with & and ;</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewText"id="xmlNewText"></a>Function: xmlNewText</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewText (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
</pre><p>Creation of a new child element, added at the end of @parent children list. @ns and @content parameters are optional (NULL). If @ns is NULL, the newly created element inherits the namespace of @parent. If @content is non NULL, a child TEXT node will be created containing the string @content. NOTE: Use xmlNewChild() if @content will contain entities that need to be preserved. Use this function, xmlNewTextChild(), if you need to ensure that reserved XML chars that might appear in @content, such as the ampersand, greater-than or less-than signs, are automatically replaced by their XML escaped entity representations.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>parent</tt></i>:</span></td><td>the parent node</td></tr><tr><td><spanclass="term"><i><tt>ns</tt></i>:</span></td><td>a namespace if any</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the name of the child</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the text content of the child if any.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNewTextLen"id="xmlNewTextLen"></a>Function: xmlNewTextLen</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNewTextLen (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content, <br/> int len)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the text content</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the text len.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the new node object.</td></tr></tbody></table></div><h3><aname="xmlNextElementSibling"id="xmlNextElementSibling"></a>Function: xmlNextElementSibling</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlNextElementSibling (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node)<br/>
</pre><p>Finds the first closest next sibling of the node which is an element node. Note the handling of entities references is different than in the W3C DOM element traversal spec since we don't have back <ahref="libxml-SAX.html#reference">reference</a> from entities content to entities references.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the current node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the next element sibling or NULL if not available</td></tr></tbody></table></div><h3><aname="xmlNodeAddContent"id="xmlNodeAddContent"></a>Function: xmlNodeAddContent</h3><preclass="programlisting">void xmlNodeAddContent (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content)<br/>
</pre><p>Append the extra substring to the node content. NOTE: In contrast to xmlNodeSetContent(), @content is supposed to be raw text, so unescaped XML special chars are allowed, entity references are not supported.</p>
</pre><p>Append the extra substring to the node content. NOTE: In contrast to xmlNodeSetContentLen(), @content is supposed to be raw text, so unescaped XML special chars are allowed, entity references are not supported.</p>
</pre><p>Read the value of a node @cur, this can be either the text carried directly by this node if it's a TEXT node or the aggregate string of the values carried by this node child's (TEXT and ENTITY_REF). Entity references are substituted. Fills up the buffer @buffer with this value</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buffer</tt></i>:</span></td><td>a buffer</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being read</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><h3><aname="xmlNodeDump"id="xmlNodeDump"></a>Function: xmlNodeDump</h3><preclass="programlisting">int xmlNodeDump (<ahref="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/> int level, <br/> int format)<br/>
</pre><p>Dump an XML node, recursive behaviour,children are printed too. Note that @format = 1 provide node indenting only if <ahref="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a> = 1 or xmlKeepBlanksDefault(0) was called Since this is using <ahref="libxml-tree.html#xmlBuffer">xmlBuffer</a> structures it is limited to 2GB and somehow deprecated, use xmlBufNodeDump() instead.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>the XML buffer output</td></tr><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the current node</td></tr><tr><td><spanclass="term"><i><tt>level</tt></i>:</span></td><td>the imbrication level for indenting</td></tr><tr><td><spanclass="term"><i><tt>format</tt></i>:</span></td><td>is formatting allowed</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written to the buffer or -1 in case of error</td></tr></tbody></table></div><h3><aname="xmlNodeDumpOutput"id="xmlNodeDumpOutput"></a>Function: xmlNodeDumpOutput</h3><preclass="programlisting">void xmlNodeDumpOutput (<ahref="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/> int level, <br/> int format, <br/> const char * encoding)<br/>
</pre><p>Dump an XML node, recursive behaviour, children are printed too. Note that @format = 1 provide node indenting only if <ahref="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a> = 1 or xmlKeepBlanksDefault(0) was called</p>
</pre><p>Searches for the BASE URL. The code should work on both XML and HTML document even if base mechanisms are completely different. It returns the base as defined in RFC 2396 sections 5.1.1. Base URI within Document Content and 5.1.2. Base URI from the Encapsulating Entity However it does not return the document base (5.1.3), use doc->URL in this case</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document the node pertains to</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being checked</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the base URL, or NULL if not found It's up to the caller to free the memory with xmlFree().</td></tr></tbody></table></div><h3><aname="xmlNodeGetContent"id="xmlNodeGetContent"></a>Function: xmlNodeGetContent</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlNodeGetContent (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * cur)<br/>
</pre><p>Read the value of a node, this can be either the text carried directly by this node if it's a TEXT node or the aggregate string of the values carried by this node child's (TEXT and ENTITY_REF). Entity references are substituted.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being read</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a new #xmlChar * or NULL if no content is available. It's up to the caller to free the memory with xmlFree().</td></tr></tbody></table></div><h3><aname="xmlNodeGetLang"id="xmlNodeGetLang"></a>Function: xmlNodeGetLang</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlNodeGetLang (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * cur)<br/>
</pre><p>Searches the language of a node, i.e. the values of the xml:lang <ahref="libxml-SAX.html#attribute">attribute</a> or the one carried by the nearest ancestor.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being checked</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the lang value, or NULL if not found It's up to the caller to free the memory with xmlFree().</td></tr></tbody></table></div><h3><aname="xmlNodeGetSpacePreserve"id="xmlNodeGetSpacePreserve"></a>Function: xmlNodeGetSpacePreserve</h3><preclass="programlisting">int xmlNodeGetSpacePreserve (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * cur)<br/>
</pre><p>Searches the space preserving behaviour of a node, i.e. the values of the xml:space <ahref="libxml-SAX.html#attribute">attribute</a> or the one carried by the nearest ancestor.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being checked</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>-1 if xml:space is not inherited, 0 if "default", 1 if "preserve"</td></tr></tbody></table></div><h3><aname="xmlNodeIsText"id="xmlNodeIsText"></a>Function: xmlNodeIsText</h3><preclass="programlisting">int xmlNodeIsText (const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * node)<br/>
</pre><p>Builds the string equivalent to the text contained in the Node list made of TEXTs and ENTITY_REFs, contrary to xmlNodeListGetString() this function doesn't do any character encoding handling.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>list</tt></i>:</span></td><td>a Node list</td></tr><tr><td><spanclass="term"><i><tt>inLine</tt></i>:</span></td><td>should we replace entity contents or show their external form</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the string copy, the caller must free it with xmlFree().</td></tr></tbody></table></div><h3><aname="xmlNodeListGetString"id="xmlNodeListGetString"></a>Function: xmlNodeListGetString</h3><preclass="programlisting"><ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlNodeListGetString (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> const <ahref="libxml-tree.html#xmlNode">xmlNode</a> * list, <br/> int inLine)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>list</tt></i>:</span></td><td>a Node list</td></tr><tr><td><spanclass="term"><i><tt>inLine</tt></i>:</span></td><td>should we replace entity contents or show their external form</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the string copy, the caller must free it with xmlFree().</td></tr></tbody></table></div><h3><aname="xmlNodeSetBase"id="xmlNodeSetBase"></a>Function: xmlNodeSetBase</h3><preclass="programlisting">void xmlNodeSetBase (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * uri)<br/>
</pre><p>Replace the content of a node. NOTE: @content is supposed to be a piece of XML CDATA, so it allows entity references, but XML special chars need to be escaped first by using xmlEncodeEntitiesReentrant() resp. xmlEncodeSpecialChars().</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being modified</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the new value of the content</td></tr></tbody></table></div><h3><aname="xmlNodeSetContentLen"id="xmlNodeSetContentLen"></a>Function: xmlNodeSetContentLen</h3><preclass="programlisting">void xmlNodeSetContentLen (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content, <br/> int len)<br/>
</pre><p>Replace the content of a node. NOTE: @content is supposed to be a piece of XML CDATA, so it allows entity references, but XML special chars need to be escaped first by using xmlEncodeEntitiesReentrant() resp. xmlEncodeSpecialChars().</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being modified</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the new value of the content</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the size of @content</td></tr></tbody></table></div><h3><aname="xmlNodeSetLang"id="xmlNodeSetLang"></a>Function: xmlNodeSetLang</h3><preclass="programlisting">void xmlNodeSetLang (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * lang)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being changed</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the new tag name</td></tr></tbody></table></div><h3><aname="xmlNodeSetSpacePreserve"id="xmlNodeSetSpacePreserve"></a>Function: xmlNodeSetSpacePreserve</h3><preclass="programlisting">void xmlNodeSetSpacePreserve (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur, <br/> int val)<br/>
</pre><p>Set (or reset) the space preserving behaviour of a node, i.e. the value of the xml:space attribute.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the node being changed</td></tr><tr><td><spanclass="term"><i><tt>val</tt></i>:</span></td><td>the xml:space value ("0": default, 1: "preserve")</td></tr></tbody></table></div><h3><aname="xmlPreviousElementSibling"id="xmlPreviousElementSibling"></a>Function: xmlPreviousElementSibling</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlPreviousElementSibling (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node)<br/>
</pre><p>Finds the first closest previous sibling of the node which is an element node. Note the handling of entities references is different than in the W3C DOM element traversal spec since we don't have back <ahref="libxml-SAX.html#reference">reference</a> from entities content to entities references.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the current node</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the previous element sibling or NULL if not available</td></tr></tbody></table></div><h3><aname="xmlReconciliateNs"id="xmlReconciliateNs"></a>Function: xmlReconciliateNs</h3><preclass="programlisting">int xmlReconciliateNs (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> tree)<br/>
</pre><p>This function checks that all the namespaces declared within the given tree are properly declared. This is needed for example after Copy or Cut and then paste operations. The subtree may still hold pointers to namespace declarations outside the subtree or invalid/masked. As much as possible the function try to reuse the existing namespaces found in the new environment. If not possible the new namespaces are redeclared on @tree at the top of the given subtree.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>tree</tt></i>:</span></td><td>a node defining the subtree to reconciliate</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of namespace declarations created or -1 in case of error.</td></tr></tbody></table></div><h3><aname="xmlRemoveProp"id="xmlRemoveProp"></a>Function: xmlRemoveProp</h3><preclass="programlisting">int xmlRemoveProp (<ahref="libxml-tree.html#xmlAttrPtr">xmlAttrPtr</a> cur)<br/>
</pre><p>Unlink and free one attribute, all the content is freed too Note this doesn't work for namespace definition attributes</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>an <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if success and -1 in case of error.</td></tr></tbody></table></div><h3><aname="xmlReplaceNode"id="xmlReplaceNode"></a>Function: xmlReplaceNode</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlReplaceNode (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> old, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur)<br/>
</pre><p>Unlink the old node from its current context, prune the new one at the same place. If @cur was already inserted in a document it is first unlinked from its existing context.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>the filename (or URL)</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written or -1 in case of failure.</td></tr></tbody></table></div><h3><aname="xmlSaveFileEnc"id="xmlSaveFileEnc"></a>Function: xmlSaveFileEnc</h3><preclass="programlisting">int xmlSaveFileEnc (const char * filename, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur, <br/> const char * encoding)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>the filename (or URL)</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the name of an encoding (or NULL)</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written or -1 in case of failure.</td></tr></tbody></table></div><h3><aname="xmlSaveFileTo"id="xmlSaveFileTo"></a>Function: xmlSaveFileTo</h3><preclass="programlisting">int xmlSaveFileTo (<ahref="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur, <br/> const char * encoding)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>an output I/O buffer</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the encoding if any assuming the I/O layer handles the trancoding</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written or -1 in case of failure.</td></tr></tbody></table></div><h3><aname="xmlSaveFormatFile"id="xmlSaveFormatFile"></a>Function: xmlSaveFormatFile</h3><preclass="programlisting">int xmlSaveFormatFile (const char * filename, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur, <br/> int format)<br/>
</pre><p>Dump an XML document to a file. Will use compression if compiled in and enabled. If @filename is "-" the stdout file is used. If @format is set then the document will be indented on output. Note that @format = 1 provide node indenting only if <ahref="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a> = 1 or xmlKeepBlanksDefault(0) was called</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>the filename (or URL)</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>format</tt></i>:</span></td><td>should formatting spaces been added</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written or -1 in case of failure.</td></tr></tbody></table></div><h3><aname="xmlSaveFormatFileEnc"id="xmlSaveFormatFileEnc"></a>Function: xmlSaveFormatFileEnc</h3><preclass="programlisting">int xmlSaveFormatFileEnc (const char * filename, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur, <br/> const char * encoding, <br/> int format)<br/>
</pre><p>Dump an XML document to a file or an URL.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>filename</tt></i>:</span></td><td>the filename or URL to output</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the document being saved</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the name of the encoding to use or NULL.</td></tr><tr><td><spanclass="term"><i><tt>format</tt></i>:</span></td><td>should formatting spaces be added.</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written or -1 in case of error. Note that @format = 1 provide node indenting only if <ahref="libxml-globals.html#xmlIndentTreeOutput">xmlIndentTreeOutput</a> = 1 or xmlKeepBlanksDefault(0) was called</td></tr></tbody></table></div><h3><aname="xmlSaveFormatFileTo"id="xmlSaveFormatFileTo"></a>Function: xmlSaveFormatFileTo</h3><preclass="programlisting">int xmlSaveFormatFileTo (<ahref="libxml-tree.html#xmlOutputBufferPtr">xmlOutputBufferPtr</a> buf, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> cur, <br/> const char * encoding, <br/> int format)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>buf</tt></i>:</span></td><td>an output I/O buffer</td></tr><tr><td><spanclass="term"><i><tt>cur</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>encoding</tt></i>:</span></td><td>the encoding if any assuming the I/O layer handles the trancoding</td></tr><tr><td><spanclass="term"><i><tt>format</tt></i>:</span></td><td>should formatting spaces been added</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the number of bytes written or -1 in case of failure.</td></tr></tbody></table></div><h3><aname="xmlSearchNs"id="xmlSearchNs"></a>Function: xmlSearchNs</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNsPtr">xmlNsPtr</a> xmlSearchNs (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * nameSpace)<br/>
</pre><p>Search a Ns registered under a given name space for a document. recurse on the parents until it finds the defined namespace or return NULL otherwise. @nameSpace can be NULL, this is a search for the default namespace. We don't allow to cross entities boundaries. If you don't declare the namespace within those you will be in troubles !!! A warning is generated to cover this case.</p>
</pre><p>Search a Ns aliasing a given URI. Recurse on the parents until it finds the defined namespace or return NULL otherwise.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the current node</td></tr><tr><td><spanclass="term"><i><tt>href</tt></i>:</span></td><td>the namespace value</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the namespace pointer or NULL.</td></tr></tbody></table></div><h3><aname="xmlSetBufferAllocationScheme"id="xmlSetBufferAllocationScheme"></a>Function: xmlSetBufferAllocationScheme</h3><preclass="programlisting">void xmlSetBufferAllocationScheme (<ahref="libxml-tree.html#xmlBufferAllocationScheme">xmlBufferAllocationScheme</a> scheme)<br/>
</pre><p>Set the buffer allocation method. Types are <ahref="libxml-tree.html#XML_BUFFER_ALLOC_EXACT">XML_BUFFER_ALLOC_EXACT</a> - use exact sizes, keeps memory usage down <ahref="libxml-tree.html#XML_BUFFER_ALLOC_DOUBLEIT">XML_BUFFER_ALLOC_DOUBLEIT</a> - double buffer when extra needed, improves performance</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>scheme</tt></i>:</span></td><td>allocation method to use</td></tr></tbody></table></div><h3><aname="xmlSetCompressMode"id="xmlSetCompressMode"></a>Function: xmlSetCompressMode</h3><preclass="programlisting">void xmlSetCompressMode (int mode)<br/>
</pre><p>set the default compression mode used, ZLIB based Correct values: 0 (uncompressed) to 9 (max compression)</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>mode</tt></i>:</span></td><td>the compression ratio</td></tr></tbody></table></div><h3><aname="xmlSetDocCompressMode"id="xmlSetDocCompressMode"></a>Function: xmlSetDocCompressMode</h3><preclass="programlisting">void xmlSetDocCompressMode (<ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc, <br/> int mode)<br/>
</pre><p>set the compression ratio for a document, ZLIB based Correct values: 0 (uncompressed) to 9 (max compression)</p>
</pre><p>Set (or reset) an <ahref="libxml-SAX.html#attribute">attribute</a> carried by a node. The ns structure must be in scope, this is not checked</p>
</pre><p>Set (or reset) an <ahref="libxml-SAX.html#attribute">attribute</a> carried by a node. If @name has a prefix, then the corresponding namespace-binding will be used, if in scope; it is an error it there's no such ns-binding for the prefix in scope.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> name (a QName)</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><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> pointer.</td></tr></tbody></table></div><h3><aname="xmlSetTreeDoc"id="xmlSetTreeDoc"></a>Function: xmlSetTreeDoc</h3><preclass="programlisting">void xmlSetTreeDoc (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> tree, <br/><ahref="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the full QName</td></tr><tr><td><spanclass="term"><i><tt>prefix</tt></i>:</span></td><td>a <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> **</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>NULL if not a QName, otherwise the local part, and prefix is updated to get the Prefix if any.</td></tr></tbody></table></div><h3><aname="xmlSplitQName3"id="xmlSplitQName3"></a>Function: xmlSplitQName3</h3><preclass="programlisting">const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * xmlSplitQName3 (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * name, <br/> int * len)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the full QName</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>an int *</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>NULL if it is not a Qualified Name, otherwise, update len with the length in byte of the prefix and return a pointer to the start of the name without the prefix</td></tr></tbody></table></div><h3><aname="xmlStringGetNodeList"id="xmlStringGetNodeList"></a>Function: xmlStringGetNodeList</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlStringGetNodeList (const <ahref="libxml-tree.html#xmlDoc">xmlDoc</a> * doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value of the <ahref="libxml-SAX.html#attribute">attribute</a></td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the first child</td></tr></tbody></table></div><h3><aname="xmlStringLenGetNodeList"id="xmlStringLenGetNodeList"></a>Function: xmlStringLenGetNodeList</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlStringLenGetNodeList (const <ahref="libxml-tree.html#xmlDoc">xmlDoc</a> * doc, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value, <br/> int len)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>doc</tt></i>:</span></td><td>the document</td></tr><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value of the text</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>the length of the string value</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>a pointer to the first child</td></tr></tbody></table></div><h3><aname="xmlTextConcat"id="xmlTextConcat"></a>Function: xmlTextConcat</h3><preclass="programlisting">int xmlTextConcat (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> node, <br/> const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * content, <br/> int len)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>content</tt></i>:</span></td><td>the content</td></tr><tr><td><spanclass="term"><i><tt>len</tt></i>:</span></td><td>@content length</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>-1 in case of error, 0 otherwise</td></tr></tbody></table></div><h3><aname="xmlTextMerge"id="xmlTextMerge"></a>Function: xmlTextMerge</h3><preclass="programlisting"><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> xmlTextMerge (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> first, <br/><ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> second)<br/>
</pre><p>Merge two text nodes into one</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>first</tt></i>:</span></td><td>the first text node</td></tr><tr><td><spanclass="term"><i><tt>second</tt></i>:</span></td><td>the second text node being merged</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>the first text node augmented</td></tr></tbody></table></div><h3><aname="xmlUnlinkNode"id="xmlUnlinkNode"></a>Function: xmlUnlinkNode</h3><preclass="programlisting">void xmlUnlinkNode (<ahref="libxml-tree.html#xmlNodePtr">xmlNodePtr</a> cur)<br/>
</pre><p>Unlink a node from it's current context, the node is not freed If one need to free the node, use xmlFreeNode() routine after the unlink to discard it. Note that namespace nodes can't be unlinked as they do not have pointer to their parent.</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>node</tt></i>:</span></td><td>the node</td></tr><tr><td><spanclass="term"><i><tt>name</tt></i>:</span></td><td>the <ahref="libxml-SAX.html#attribute">attribute</a> name</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</span></td><td>0 if successful, -1 if not found</td></tr></tbody></table></div><h3><aname="xmlValidateNCName"id="xmlValidateNCName"></a>Function: xmlValidateNCName</h3><preclass="programlisting">int xmlValidateNCName (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value, <br/> int space)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value to check</td></tr><tr><td><spanclass="term"><i><tt>space</tt></i>:</span></td><td>allow spaces in front and end of the string</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</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><h3><aname="xmlValidateNMToken"id="xmlValidateNMToken"></a>Function: xmlValidateNMToken</h3><preclass="programlisting">int xmlValidateNMToken (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value, <br/> int space)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value to check</td></tr><tr><td><spanclass="term"><i><tt>space</tt></i>:</span></td><td>allow spaces in front and end of the string</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</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><h3><aname="xmlValidateName"id="xmlValidateName"></a>Function: xmlValidateName</h3><preclass="programlisting">int xmlValidateName (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value, <br/> int space)<br/>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value to check</td></tr><tr><td><spanclass="term"><i><tt>space</tt></i>:</span></td><td>allow spaces in front and end of the string</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</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><h3><aname="xmlValidateQName"id="xmlValidateQName"></a>Function: xmlValidateQName</h3><preclass="programlisting">int xmlValidateQName (const <ahref="libxml-xmlstring.html#xmlChar">xmlChar</a> * value, <br/> int space)<br/>
</pre><p>Check that a value conforms to the lexical space of QName</p>
<divclass="variablelist"><tableborder="0"><colalign="left"/><tbody><tr><td><spanclass="term"><i><tt>value</tt></i>:</span></td><td>the value to check</td></tr><tr><td><spanclass="term"><i><tt>space</tt></i>:</span></td><td>allow spaces in front and end of the string</td></tr><tr><td><spanclass="term"><i><tt>Returns</tt></i>:</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><p><ahref="../bugs.html">Daniel Veillard</a></p></td></tr></table></td></tr></table></td></tr></table></td></tr></table></td></tr></table></body></html>
