libxml2/doc/html/libxml-entities.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>entities</title><meta name="generator" content="DocBook XSL Stylesheets V1.58.1"><style xmlns="http://www.w3.org/TR/xhtml1/transitional" type="text/css">
   2         .synopsis, .classsynopsis {
   3             background: #eeeeee;
   4             border: solid 1px #aaaaaa;
   5             padding: 0.5em;
   6         }
   7         .programlisting {
   8             background: #eeeeff;
   9             border: solid 1px #aaaaff;
  10             padding: 0.5em;
  11         }
  12         .variablelist {
  13             padding: 4px;
  14             margin-left: 3em;
  15         }
  16         .navigation {
  17             background: #ffeeee;
  18             border: solid 1px #ffaaaa;
  19             margin-top: 0.5em;
  20             margin-bottom: 0.5em;
  21         }
  22         .navigation a {
  23             color: #770000;
  24         }
  25         .navigation a:visited {
  26             color: #550000;
  27         }
  28         .navigation .title {
  29             font-size: 200%;
  30         }
  31       </style><link rel="home" href="index.html" title="Gnome XML Library Reference Manual"><link rel="up" href="libxml-lib.html" title="Libxml Library Reference"><link rel="previous" href="libxml-tree.html" title="tree"><link rel="next" href="libxml-valid.html" title="valid"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libxml-tree.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></img></a></td><td><a accesskey="u" href="libxml-lib.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></img></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></img></a></td><th width="100%" align="center">Gnome XML Library Reference Manual</th><td><a accesskey="n" href="libxml-valid.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></img></a></td></tr></table><div class="refentry" lang="en"><a name="libxml-entities"></a><div class="titlepage"></div><div class="refnamediv"><h2>entities</h2><p>entities &#8212; </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">
  32
  33
  34
  35 enum        <a href="libxml-entities.html#xmlEntityType">xmlEntityType</a>;
  36 struct      <a href="libxml-tree.html#xmlEntity">xmlEntity</a>;
  37 typedef     <a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a>;
  38 void        <a href="libxml-entities.html#xmlInitializePredefinedEntities">xmlInitializePredefinedEntities</a> (void);
  39 <a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlAddDocEntity">xmlAddDocEntity</a>                (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
  40                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
  41                                              int type,
  42                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
  43                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID,
  44                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
  45 <a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlAddDtdEntity">xmlAddDtdEntity</a>                (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
  46                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
  47                                              int type,
  48                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
  49                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID,
  50                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);
  51 <a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlGetPredefinedEntity">xmlGetPredefinedEntity</a>         (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
  52 <a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlGetDocEntity">xmlGetDocEntity</a>                (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
  53                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
  54 <a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlGetDtdEntity">xmlGetDtdEntity</a>                (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
  55                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
  56 <a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> <a href="libxml-entities.html#xmlGetParameterEntity">xmlGetParameterEntity</a>          (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
  57                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);
  58 const <a href="libxml-tree.html#xmlChar">xmlChar</a>* <a href="libxml-entities.html#xmlEncodeEntities">xmlEncodeEntities</a>            (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
  59                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);
  60 <a href="libxml-tree.html#xmlChar">xmlChar</a>*    <a href="libxml-entities.html#xmlEncodeEntitiesReentrant">xmlEncodeEntitiesReentrant</a>      (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
  61                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);
  62 <a href="libxml-tree.html#xmlChar">xmlChar</a>*    <a href="libxml-entities.html#xmlEncodeSpecialChars">xmlEncodeSpecialChars</a>           (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
  63                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);
  64 <a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> <a href="libxml-entities.html#xmlCreateEntitiesTable">xmlCreateEntitiesTable</a>  (void);
  65 <a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> <a href="libxml-entities.html#xmlCopyEntitiesTable">xmlCopyEntitiesTable</a>    (<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);
  66 void        <a href="libxml-entities.html#xmlFreeEntitiesTable">xmlFreeEntitiesTable</a>            (<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);
  67 void        <a href="libxml-entities.html#xmlDumpEntitiesTable">xmlDumpEntitiesTable</a>            (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
  68                                              <a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);
  69 void        <a href="libxml-entities.html#xmlDumpEntityDecl">xmlDumpEntityDecl</a>               (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
  70                                              <a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> ent);
  71 void        <a href="libxml-entities.html#xmlCleanupPredefinedEntities">xmlCleanupPredefinedEntities</a>    (void);
  72 </pre></div><div class="refsect1" lang="en"><h2>Description</h2><p>
  73
  74 </p></div><div class="refsect1" lang="en"><h2>Details</h2><div class="refsect2" lang="en"><h3><a name="xmlEntityType"></a>enum xmlEntityType</h3><pre class="programlisting">typedef enum {
  75     XML_INTERNAL_GENERAL_ENTITY = 1,
  76     XML_EXTERNAL_GENERAL_PARSED_ENTITY = 2,
  77     XML_EXTERNAL_GENERAL_UNPARSED_ENTITY = 3,
  78     XML_INTERNAL_PARAMETER_ENTITY = 4,
  79     XML_EXTERNAL_PARAMETER_ENTITY = 5,
  80     XML_INTERNAL_PREDEFINED_ENTITY = 6
  81 } xmlEntityType;
  82 </pre><p>
  83
  84 </p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlEntity"></a>struct xmlEntity</h3><pre class="programlisting">struct xmlEntity {
  85     void           *_private;           /* application data */
  86     xmlElementType          type;       /* XML_ENTITY_DECL, must be second ! */
  87     const xmlChar          *name;       /* Entity name */
  88     struct _xmlNode    *children;       /* First child link */
  89     struct _xmlNode        *last;       /* Last child link */
  90     struct _xmlDtd       *parent;       /* -&gt; DTD */
  91     struct _xmlNode        *next;       /* next sibling link  */
  92     struct _xmlNode        *prev;       /* previous sibling link  */
  93     struct _xmlDoc          *doc;       /* the containing document */
  94
  95     xmlChar                *orig;       /* content without ref substitution */
  96     xmlChar             *content;       /* content or ndata if unparsed */
  97     int                   length;       /* the content length */
  98     xmlEntityType          etype;       /* The entity type */
  99     const xmlChar    *ExternalID;       /* External identifier for PUBLIC */
 100     const xmlChar      *SystemID;       /* URI for a SYSTEM or PUBLIC Entity */
 101
 102     struct _xmlEntity     *nexte;       /* unused */
 103     const xmlChar           *URI;       /* the full URI as computed */
 104     int                    owner;       /* does the entity own the childrens */
 105 };
 106 </pre><p>
 107
 108 </p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlEntitiesTablePtr"></a>xmlEntitiesTablePtr</h3><pre class="programlisting">typedef xmlEntitiesTable *xmlEntitiesTablePtr;
 109 </pre><p>
 110
 111 </p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlInitializePredefinedEntities"></a>xmlInitializePredefinedEntities ()</h3><pre class="programlisting">void        xmlInitializePredefinedEntities (void);</pre><p>
 112 Set up the predefined entities.</p><p>
 113
 114 </p></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlAddDocEntity"></a>xmlAddDocEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlAddDocEntity                (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
 115                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
 116                                              int type,
 117                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
 118                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID,
 119                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
 120 Register a new entity for this document.</p><p>
 121
 122 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>doc</tt></i> :</span></td><td>  the document
 123 </td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td>  the entity name
 124 </td></tr><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td>  the entity type XML_xxx_yyy_ENTITY
 125 </td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i> :</span></td><td>  the entity external ID if available
 126 </td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i> :</span></td><td>  the entity system ID if available
 127 </td></tr><tr><td><span class="term"><i><tt>content</tt></i> :</span></td><td>  the entity content
 128 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>a pointer to the entity or NULL in case of error
 129 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlAddDtdEntity"></a>xmlAddDtdEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlAddDtdEntity                (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
 130                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name,
 131                                              int type,
 132                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *ExternalID,
 133                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *SystemID,
 134                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *content);</pre><p>
 135 Register a new entity for this document DTD external subset.</p><p>
 136
 137 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>doc</tt></i> :</span></td><td>  the document
 138 </td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td>  the entity name
 139 </td></tr><tr><td><span class="term"><i><tt>type</tt></i> :</span></td><td>  the entity type XML_xxx_yyy_ENTITY
 140 </td></tr><tr><td><span class="term"><i><tt>ExternalID</tt></i> :</span></td><td>  the entity external ID if available
 141 </td></tr><tr><td><span class="term"><i><tt>SystemID</tt></i> :</span></td><td>  the entity system ID if available
 142 </td></tr><tr><td><span class="term"><i><tt>content</tt></i> :</span></td><td>  the entity content
 143 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>a pointer to the entity or NULL in case of error
 144 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlGetPredefinedEntity"></a>xmlGetPredefinedEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlGetPredefinedEntity         (const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
 145 Check whether this name is an predefined entity.</p><p>
 146
 147 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td>  the entity name
 148 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>NULL if not, otherwise the entity
 149 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlGetDocEntity"></a>xmlGetDocEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlGetDocEntity                (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
 150                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
 151 Do an entity lookup in the document entity hash table and
 152 returns the corresponding entity, otherwise a lookup is done
 153 in the predefined entities too.</p><p>
 154
 155 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>doc</tt></i> :</span></td><td>  the document referencing the entity
 156 </td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td>  the entity name
 157 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>A pointer to the entity structure or NULL if not found.
 158 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlGetDtdEntity"></a>xmlGetDtdEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlGetDtdEntity                (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
 159                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
 160 Do an entity lookup in the DTD entity hash table and
 161 returns the corresponding entity, if found.
 162 Note: the first argument is the document node, not the DTD node.</p><p>
 163
 164 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>doc</tt></i> :</span></td><td>  the document referencing the entity
 165 </td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td>  the entity name
 166 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>A pointer to the entity structure or NULL if not found.
 167 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlGetParameterEntity"></a>xmlGetParameterEntity ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> xmlGetParameterEntity          (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
 168                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *name);</pre><p>
 169 Do an entity lookup in the internal and external subsets and
 170 returns the corresponding parameter entity, if found.</p><p>
 171
 172 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>doc</tt></i> :</span></td><td>  the document referencing the entity
 173 </td></tr><tr><td><span class="term"><i><tt>name</tt></i> :</span></td><td>  the entity name
 174 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>A pointer to the entity structure or NULL if not found.
 175 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlEncodeEntities"></a>xmlEncodeEntities ()</h3><pre class="programlisting">const <a href="libxml-tree.html#xmlChar">xmlChar</a>* xmlEncodeEntities            (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
 176                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);</pre><p>
 177 Do a global encoding of a string, replacing the predefined entities
 178 and non ASCII values with their entities and CharRef counterparts.
 179 </p><p>
 180 TODO: remove xmlEncodeEntities, once we are not afraid of breaking binary
 181       compatibility
 182 </p><p>
 183 People must migrate their code to xmlEncodeEntitiesReentrant !
 184 This routine will issue a warning when encountered.</p><p>
 185
 186 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>doc</tt></i> :</span></td><td>  the document containing the string
 187 </td></tr><tr><td><span class="term"><i><tt>input</tt></i> :</span></td><td>  A string to convert to XML.
 188 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>A newly allocated string with the substitution done.
 189 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlEncodeEntitiesReentrant"></a>xmlEncodeEntitiesReentrant ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>*    xmlEncodeEntitiesReentrant      (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
 190                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);</pre><p>
 191 Do a global encoding of a string, replacing the predefined entities
 192 and non ASCII values with their entities and CharRef counterparts.
 193 Contrary to xmlEncodeEntities, this routine is reentrant, and result
 194 must be deallocated.</p><p>
 195
 196 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>doc</tt></i> :</span></td><td>  the document containing the string
 197 </td></tr><tr><td><span class="term"><i><tt>input</tt></i> :</span></td><td>  A string to convert to XML.
 198 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>A newly allocated string with the substitution done.
 199 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlEncodeSpecialChars"></a>xmlEncodeSpecialChars ()</h3><pre class="programlisting"><a href="libxml-tree.html#xmlChar">xmlChar</a>*    xmlEncodeSpecialChars           (<a href="libxml-tree.html#xmlDocPtr">xmlDocPtr</a> doc,
 200                                              const <a href="libxml-tree.html#xmlChar">xmlChar</a> *input);</pre><p>
 201 Do a global encoding of a string, replacing the predefined entities
 202 this routine is reentrant, and result must be deallocated.</p><p>
 203
 204 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>doc</tt></i> :</span></td><td>  the document containing the string
 205 </td></tr><tr><td><span class="term"><i><tt>input</tt></i> :</span></td><td>  A string to convert to XML.
 206 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>A newly allocated string with the substitution done.
 207 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlCreateEntitiesTable"></a>xmlCreateEntitiesTable ()</h3><pre class="programlisting"><a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> xmlCreateEntitiesTable  (void);</pre><p>
 208 create and initialize an empty entities hash table.</p><p>
 209
 210 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the xmlEntitiesTablePtr just created or NULL in case of error.
 211 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlCopyEntitiesTable"></a>xmlCopyEntitiesTable ()</h3><pre class="programlisting"><a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> xmlCopyEntitiesTable    (<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);</pre><p>
 212 Build a copy of an entity table.</p><p>
 213
 214 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>table</tt></i> :</span></td><td>  An entity table
 215 </td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td>the new xmlEntitiesTablePtr or NULL in case of error.
 216 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlFreeEntitiesTable"></a>xmlFreeEntitiesTable ()</h3><pre class="programlisting">void        xmlFreeEntitiesTable            (<a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);</pre><p>
 217 Deallocate the memory used by an entities hash table.</p><p>
 218
 219 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>table</tt></i> :</span></td><td>  An entity table
 220 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlDumpEntitiesTable"></a>xmlDumpEntitiesTable ()</h3><pre class="programlisting">void        xmlDumpEntitiesTable            (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
 221                                              <a href="libxml-entities.html#xmlEntitiesTablePtr">xmlEntitiesTablePtr</a> table);</pre><p>
 222 This will dump the content of the entity table as an XML DTD definition</p><p>
 223
 224 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>buf</tt></i> :</span></td><td>  An XML buffer.
 225 </td></tr><tr><td><span class="term"><i><tt>table</tt></i> :</span></td><td>  An entity table
 226 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlDumpEntityDecl"></a>xmlDumpEntityDecl ()</h3><pre class="programlisting">void        xmlDumpEntityDecl               (<a href="libxml-tree.html#xmlBufferPtr">xmlBufferPtr</a> buf,
 227                                              <a href="libxml-tree.html#xmlEntityPtr">xmlEntityPtr</a> ent);</pre><p>
 228 This will dump the content of the entity table as an XML DTD definition</p><p>
 229
 230 </p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i><tt>buf</tt></i> :</span></td><td>  An XML buffer.
 231 </td></tr><tr><td><span class="term"><i><tt>ent</tt></i> :</span></td><td>  An entity table
 232 </td></tr></tbody></table></div></div><hr xmlns="http://www.w3.org/TR/xhtml1/transitional"></hr><div class="refsect2" lang="en"><h3><a name="xmlCleanupPredefinedEntities"></a>xmlCleanupPredefinedEntities ()</h3><pre class="programlisting">void        xmlCleanupPredefinedEntities    (void);</pre><p>
 233 Cleanup up the predefined entities table.</p><p>
 234
 235 </p></div></div></div><table xmlns="http://www.w3.org/TR/xhtml1/transitional" class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libxml-tree.html"><b>&lt;&lt; tree</b></a></td><td align="right"><a accesskey="n" href="libxml-valid.html"><b>valid &gt;&gt;</b></a></td></tr></table></body></html>