Initial revision
[TestXSLT.git] / libxml2 / doc / html / libxml-entities.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >entities</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8 "><LINK
9 REL="HOME"
10 TITLE="Gnome XML Library Reference Manual"
11 HREF="book1.html"><LINK
12 REL="UP"
13 TITLE="Libxml Library Reference"
14 HREF="libxml-lib.html"><LINK
15 REL="PREVIOUS"
16 TITLE="tree"
17 HREF="libxml-tree.html"><LINK
18 REL="NEXT"
19 TITLE="valid"
20 HREF="libxml-valid.html"></HEAD
21 ><BODY
22 CLASS="REFENTRY"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 WIDTH="100%"
32 BORDER="0"
33 BGCOLOR="#000000"
34 CELLPADDING="1"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="4"
39 ALIGN="center"
40 ><FONT
41 COLOR="#FFFFFF"
42 SIZE="5"
43 >Gnome XML Library Reference Manual</FONT
44 ></TH
45 ></TR
46 ><TR
47 ><TD
48 WIDTH="25%"
49 BGCOLOR="#C00000"
50 ALIGN="left"
51 ><A
52 HREF="libxml-tree.html"
53 ><FONT
54 COLOR="#FFFFFF"
55 SIZE="3"
56 ><B
57 >&#60;&#60;&#60; Previous Page</B
58 ></FONT
59 ></A
60 ></TD
61 ><TD
62 WIDTH="25%"
63 BGCOLOR="#0000C0"
64 ALIGN="center"
65 ><FONT
66 COLOR="#FFFFFF"
67 SIZE="3"
68 ><B
69 ><A
70 HREF="book1.html"
71 ><FONT
72 COLOR="#FFFFFF"
73 SIZE="3"
74 ><B
75 >Home</B
76 ></FONT
77 ></A
78 ></B
79 ></FONT
80 ></TD
81 ><TD
82 WIDTH="25%"
83 BGCOLOR="#00C000"
84 ALIGN="center"
85 ><FONT
86 COLOR="#FFFFFF"
87 SIZE="3"
88 ><B
89 ><A
90 HREF="libxml-lib.html"
91 ><FONT
92 COLOR="#FFFFFF"
93 SIZE="3"
94 ><B
95 >Up</B
96 ></FONT
97 ></A
98 ></B
99 ></FONT
100 ></TD
101 ><TD
102 WIDTH="25%"
103 BGCOLOR="#C00000"
104 ALIGN="right"
105 ><A
106 HREF="libxml-valid.html"
107 ><FONT
108 COLOR="#FFFFFF"
109 SIZE="3"
110 ><B
111 >Next Page &#62;&#62;&#62;</B
112 ></FONT
113 ></A
114 ></TD
115 ></TR
116 ></TABLE
117 ></DIV
118 ><H1
119 ><A
120 NAME="LIBXML-ENTITIES">entities</H1
121 ><DIV
122 CLASS="REFNAMEDIV"
123 ><A
124 NAME="AEN8121"
125 ></A
126 ><H2
127 >Name</H2
128 >entities&nbsp;--&nbsp;</DIV
129 ><DIV
130 CLASS="REFSYNOPSISDIV"
131 ><A
132 NAME="AEN8124"><H2
133 >Synopsis</H2
134 ><TABLE
135 BORDER="0"
136 BGCOLOR="#D6E8FF"
137 WIDTH="100%"
138 CELLPADDING="6"
139 ><TR
140 ><TD
141 ><PRE
142 CLASS="SYNOPSIS"
143 >&#13;
144
145 enum        <A
146 HREF="libxml-entities.html#XMLENTITYTYPE"
147 >xmlEntityType</A
148 >;
149 struct      <A
150 HREF="libxml-tree.html#XMLENTITY"
151 >xmlEntity</A
152 >;
153 typedef     <A
154 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
155 >xmlEntitiesTablePtr</A
156 >;
157 void        <A
158 HREF="libxml-entities.html#XMLINITIALIZEPREDEFINEDENTITIES"
159 >xmlInitializePredefinedEntities</A
160 > (void);
161 <A
162 HREF="libxml-tree.html#XMLENTITYPTR"
163 >xmlEntityPtr</A
164 > <A
165 HREF="libxml-entities.html#XMLADDDOCENTITY"
166 >xmlAddDocEntity</A
167 >                (<A
168 HREF="libxml-tree.html#XMLDOCPTR"
169 >xmlDocPtr</A
170 > doc,
171                                              const <A
172 HREF="libxml-tree.html#XMLCHAR"
173 >xmlChar</A
174 > *name,
175                                              int type,
176                                              const <A
177 HREF="libxml-tree.html#XMLCHAR"
178 >xmlChar</A
179 > *ExternalID,
180                                              const <A
181 HREF="libxml-tree.html#XMLCHAR"
182 >xmlChar</A
183 > *SystemID,
184                                              const <A
185 HREF="libxml-tree.html#XMLCHAR"
186 >xmlChar</A
187 > *content);
188 <A
189 HREF="libxml-tree.html#XMLENTITYPTR"
190 >xmlEntityPtr</A
191 > <A
192 HREF="libxml-entities.html#XMLADDDTDENTITY"
193 >xmlAddDtdEntity</A
194 >                (<A
195 HREF="libxml-tree.html#XMLDOCPTR"
196 >xmlDocPtr</A
197 > doc,
198                                              const <A
199 HREF="libxml-tree.html#XMLCHAR"
200 >xmlChar</A
201 > *name,
202                                              int type,
203                                              const <A
204 HREF="libxml-tree.html#XMLCHAR"
205 >xmlChar</A
206 > *ExternalID,
207                                              const <A
208 HREF="libxml-tree.html#XMLCHAR"
209 >xmlChar</A
210 > *SystemID,
211                                              const <A
212 HREF="libxml-tree.html#XMLCHAR"
213 >xmlChar</A
214 > *content);
215 <A
216 HREF="libxml-tree.html#XMLENTITYPTR"
217 >xmlEntityPtr</A
218 > <A
219 HREF="libxml-entities.html#XMLGETPREDEFINEDENTITY"
220 >xmlGetPredefinedEntity</A
221 >         (const <A
222 HREF="libxml-tree.html#XMLCHAR"
223 >xmlChar</A
224 > *name);
225 <A
226 HREF="libxml-tree.html#XMLENTITYPTR"
227 >xmlEntityPtr</A
228 > <A
229 HREF="libxml-entities.html#XMLGETDOCENTITY"
230 >xmlGetDocEntity</A
231 >                (<A
232 HREF="libxml-tree.html#XMLDOCPTR"
233 >xmlDocPtr</A
234 > doc,
235                                              const <A
236 HREF="libxml-tree.html#XMLCHAR"
237 >xmlChar</A
238 > *name);
239 <A
240 HREF="libxml-tree.html#XMLENTITYPTR"
241 >xmlEntityPtr</A
242 > <A
243 HREF="libxml-entities.html#XMLGETDTDENTITY"
244 >xmlGetDtdEntity</A
245 >                (<A
246 HREF="libxml-tree.html#XMLDOCPTR"
247 >xmlDocPtr</A
248 > doc,
249                                              const <A
250 HREF="libxml-tree.html#XMLCHAR"
251 >xmlChar</A
252 > *name);
253 <A
254 HREF="libxml-tree.html#XMLENTITYPTR"
255 >xmlEntityPtr</A
256 > <A
257 HREF="libxml-entities.html#XMLGETPARAMETERENTITY"
258 >xmlGetParameterEntity</A
259 >          (<A
260 HREF="libxml-tree.html#XMLDOCPTR"
261 >xmlDocPtr</A
262 > doc,
263                                              const <A
264 HREF="libxml-tree.html#XMLCHAR"
265 >xmlChar</A
266 > *name);
267 const <A
268 HREF="libxml-tree.html#XMLCHAR"
269 >xmlChar</A
270 >* <A
271 HREF="libxml-entities.html#XMLENCODEENTITIES"
272 >xmlEncodeEntities</A
273 >            (<A
274 HREF="libxml-tree.html#XMLDOCPTR"
275 >xmlDocPtr</A
276 > doc,
277                                              const <A
278 HREF="libxml-tree.html#XMLCHAR"
279 >xmlChar</A
280 > *input);
281 <A
282 HREF="libxml-tree.html#XMLCHAR"
283 >xmlChar</A
284 >*    <A
285 HREF="libxml-entities.html#XMLENCODEENTITIESREENTRANT"
286 >xmlEncodeEntitiesReentrant</A
287 >      (<A
288 HREF="libxml-tree.html#XMLDOCPTR"
289 >xmlDocPtr</A
290 > doc,
291                                              const <A
292 HREF="libxml-tree.html#XMLCHAR"
293 >xmlChar</A
294 > *input);
295 <A
296 HREF="libxml-tree.html#XMLCHAR"
297 >xmlChar</A
298 >*    <A
299 HREF="libxml-entities.html#XMLENCODESPECIALCHARS"
300 >xmlEncodeSpecialChars</A
301 >           (<A
302 HREF="libxml-tree.html#XMLDOCPTR"
303 >xmlDocPtr</A
304 > doc,
305                                              const <A
306 HREF="libxml-tree.html#XMLCHAR"
307 >xmlChar</A
308 > *input);
309 <A
310 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
311 >xmlEntitiesTablePtr</A
312 > <A
313 HREF="libxml-entities.html#XMLCREATEENTITIESTABLE"
314 >xmlCreateEntitiesTable</A
315 >  (void);
316 <A
317 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
318 >xmlEntitiesTablePtr</A
319 > <A
320 HREF="libxml-entities.html#XMLCOPYENTITIESTABLE"
321 >xmlCopyEntitiesTable</A
322 >    (<A
323 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
324 >xmlEntitiesTablePtr</A
325 > table);
326 void        <A
327 HREF="libxml-entities.html#XMLFREEENTITIESTABLE"
328 >xmlFreeEntitiesTable</A
329 >            (<A
330 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
331 >xmlEntitiesTablePtr</A
332 > table);
333 void        <A
334 HREF="libxml-entities.html#XMLDUMPENTITIESTABLE"
335 >xmlDumpEntitiesTable</A
336 >            (<A
337 HREF="libxml-tree.html#XMLBUFFERPTR"
338 >xmlBufferPtr</A
339 > buf,
340                                              <A
341 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
342 >xmlEntitiesTablePtr</A
343 > table);
344 void        <A
345 HREF="libxml-entities.html#XMLDUMPENTITYDECL"
346 >xmlDumpEntityDecl</A
347 >               (<A
348 HREF="libxml-tree.html#XMLBUFFERPTR"
349 >xmlBufferPtr</A
350 > buf,
351                                              <A
352 HREF="libxml-tree.html#XMLENTITYPTR"
353 >xmlEntityPtr</A
354 > ent);
355 void        <A
356 HREF="libxml-entities.html#XMLCLEANUPPREDEFINEDENTITIES"
357 >xmlCleanupPredefinedEntities</A
358 >    (void);</PRE
359 ></TD
360 ></TR
361 ></TABLE
362 ></DIV
363 ><DIV
364 CLASS="REFSECT1"
365 ><A
366 NAME="AEN8186"
367 ></A
368 ><H2
369 >Description</H2
370 ><P
371 ></P
372 ></DIV
373 ><DIV
374 CLASS="REFSECT1"
375 ><A
376 NAME="AEN8189"
377 ></A
378 ><H2
379 >Details</H2
380 ><DIV
381 CLASS="REFSECT2"
382 ><A
383 NAME="AEN8191"
384 ></A
385 ><H3
386 ><A
387 NAME="XMLENTITYTYPE"
388 ></A
389 >enum xmlEntityType</H3
390 ><TABLE
391 BORDER="0"
392 BGCOLOR="#D6E8FF"
393 WIDTH="100%"
394 CELLPADDING="6"
395 ><TR
396 ><TD
397 ><PRE
398 CLASS="PROGRAMLISTING"
399 >typedef enum {
400     XML_INTERNAL_GENERAL_ENTITY = 1,
401     XML_EXTERNAL_GENERAL_PARSED_ENTITY = 2,
402     XML_EXTERNAL_GENERAL_UNPARSED_ENTITY = 3,
403     XML_INTERNAL_PARAMETER_ENTITY = 4,
404     XML_EXTERNAL_PARAMETER_ENTITY = 5,
405     XML_INTERNAL_PREDEFINED_ENTITY = 6
406 } xmlEntityType;</PRE
407 ></TD
408 ></TR
409 ></TABLE
410 ><P
411 ></P
412 ></DIV
413 ><HR><DIV
414 CLASS="REFSECT2"
415 ><A
416 NAME="AEN8196"
417 ></A
418 ><H3
419 ><A
420 NAME="XMLENTITY"
421 ></A
422 >struct xmlEntity</H3
423 ><TABLE
424 BORDER="0"
425 BGCOLOR="#D6E8FF"
426 WIDTH="100%"
427 CELLPADDING="6"
428 ><TR
429 ><TD
430 ><PRE
431 CLASS="PROGRAMLISTING"
432 >struct xmlEntity {
433     void           *_private;           /* application data */
434     xmlElementType          type;       /* XML_ENTITY_DECL, must be second ! */
435     const xmlChar          *name;       /* Entity name */
436     struct _xmlNode    *children;       /* First child link */
437     struct _xmlNode        *last;       /* Last child link */
438     struct _xmlDtd       *parent;       /* -&gt; DTD */
439     struct _xmlNode        *next;       /* next sibling link  */
440     struct _xmlNode        *prev;       /* previous sibling link  */
441     struct _xmlDoc          *doc;       /* the containing document */
442
443     xmlChar                *orig;       /* content without ref substitution */
444     xmlChar             *content;       /* content or ndata if unparsed */
445     int                   length;       /* the content length */
446     xmlEntityType          etype;       /* The entity type */
447     const xmlChar    *ExternalID;       /* External identifier for PUBLIC */
448     const xmlChar      *SystemID;       /* URI for a SYSTEM or PUBLIC Entity */
449
450     struct _xmlEntity     *nexte;       /* unused */
451     const xmlChar           *URI;       /* the full URI as computed */
452 };</PRE
453 ></TD
454 ></TR
455 ></TABLE
456 ><P
457 ></P
458 ></DIV
459 ><HR><DIV
460 CLASS="REFSECT2"
461 ><A
462 NAME="AEN8201"
463 ></A
464 ><H3
465 ><A
466 NAME="XMLENTITIESTABLEPTR"
467 ></A
468 >xmlEntitiesTablePtr</H3
469 ><TABLE
470 BORDER="0"
471 BGCOLOR="#D6E8FF"
472 WIDTH="100%"
473 CELLPADDING="6"
474 ><TR
475 ><TD
476 ><PRE
477 CLASS="PROGRAMLISTING"
478 >typedef xmlEntitiesTable *xmlEntitiesTablePtr;</PRE
479 ></TD
480 ></TR
481 ></TABLE
482 ><P
483 ></P
484 ></DIV
485 ><HR><DIV
486 CLASS="REFSECT2"
487 ><A
488 NAME="AEN8206"
489 ></A
490 ><H3
491 ><A
492 NAME="XMLINITIALIZEPREDEFINEDENTITIES"
493 ></A
494 >xmlInitializePredefinedEntities ()</H3
495 ><TABLE
496 BORDER="0"
497 BGCOLOR="#D6E8FF"
498 WIDTH="100%"
499 CELLPADDING="6"
500 ><TR
501 ><TD
502 ><PRE
503 CLASS="PROGRAMLISTING"
504 >void        xmlInitializePredefinedEntities (void);</PRE
505 ></TD
506 ></TR
507 ></TABLE
508 ><P
509 >Set up the predefined entities.</P
510 ><P
511 ></P
512 ></DIV
513 ><HR><DIV
514 CLASS="REFSECT2"
515 ><A
516 NAME="AEN8212"
517 ></A
518 ><H3
519 ><A
520 NAME="XMLADDDOCENTITY"
521 ></A
522 >xmlAddDocEntity ()</H3
523 ><TABLE
524 BORDER="0"
525 BGCOLOR="#D6E8FF"
526 WIDTH="100%"
527 CELLPADDING="6"
528 ><TR
529 ><TD
530 ><PRE
531 CLASS="PROGRAMLISTING"
532 ><A
533 HREF="libxml-tree.html#XMLENTITYPTR"
534 >xmlEntityPtr</A
535 > xmlAddDocEntity                (<A
536 HREF="libxml-tree.html#XMLDOCPTR"
537 >xmlDocPtr</A
538 > doc,
539                                              const <A
540 HREF="libxml-tree.html#XMLCHAR"
541 >xmlChar</A
542 > *name,
543                                              int type,
544                                              const <A
545 HREF="libxml-tree.html#XMLCHAR"
546 >xmlChar</A
547 > *ExternalID,
548                                              const <A
549 HREF="libxml-tree.html#XMLCHAR"
550 >xmlChar</A
551 > *SystemID,
552                                              const <A
553 HREF="libxml-tree.html#XMLCHAR"
554 >xmlChar</A
555 > *content);</PRE
556 ></TD
557 ></TR
558 ></TABLE
559 ><P
560 >Register a new entity for this document.</P
561 ><P
562 ></P
563 ><DIV
564 CLASS="INFORMALTABLE"
565 ><A
566 NAME="AEN8224"><P
567 ></P
568 ><TABLE
569 BORDER="0"
570 WIDTH="100%"
571 BGCOLOR="#FFD0D0"
572 CELLSPACING="0"
573 CELLPADDING="4"
574 CLASS="CALSTABLE"
575 ><TBODY
576 ><TR
577 ><TD
578 WIDTH="20%"
579 ALIGN="RIGHT"
580 VALIGN="TOP"
581 ><TT
582 CLASS="PARAMETER"
583 ><I
584 >doc</I
585 ></TT
586 >&nbsp;:</TD
587 ><TD
588 WIDTH="80%"
589 ALIGN="LEFT"
590 VALIGN="TOP"
591 >  the document</TD
592 ></TR
593 ><TR
594 ><TD
595 WIDTH="20%"
596 ALIGN="RIGHT"
597 VALIGN="TOP"
598 ><TT
599 CLASS="PARAMETER"
600 ><I
601 >name</I
602 ></TT
603 >&nbsp;:</TD
604 ><TD
605 WIDTH="80%"
606 ALIGN="LEFT"
607 VALIGN="TOP"
608 >  the entity name</TD
609 ></TR
610 ><TR
611 ><TD
612 WIDTH="20%"
613 ALIGN="RIGHT"
614 VALIGN="TOP"
615 ><TT
616 CLASS="PARAMETER"
617 ><I
618 >type</I
619 ></TT
620 >&nbsp;:</TD
621 ><TD
622 WIDTH="80%"
623 ALIGN="LEFT"
624 VALIGN="TOP"
625 >  the entity type XML_xxx_yyy_ENTITY</TD
626 ></TR
627 ><TR
628 ><TD
629 WIDTH="20%"
630 ALIGN="RIGHT"
631 VALIGN="TOP"
632 ><TT
633 CLASS="PARAMETER"
634 ><I
635 >ExternalID</I
636 ></TT
637 >&nbsp;:</TD
638 ><TD
639 WIDTH="80%"
640 ALIGN="LEFT"
641 VALIGN="TOP"
642 >  the entity external ID if available</TD
643 ></TR
644 ><TR
645 ><TD
646 WIDTH="20%"
647 ALIGN="RIGHT"
648 VALIGN="TOP"
649 ><TT
650 CLASS="PARAMETER"
651 ><I
652 >SystemID</I
653 ></TT
654 >&nbsp;:</TD
655 ><TD
656 WIDTH="80%"
657 ALIGN="LEFT"
658 VALIGN="TOP"
659 >  the entity system ID if available</TD
660 ></TR
661 ><TR
662 ><TD
663 WIDTH="20%"
664 ALIGN="RIGHT"
665 VALIGN="TOP"
666 ><TT
667 CLASS="PARAMETER"
668 ><I
669 >content</I
670 ></TT
671 >&nbsp;:</TD
672 ><TD
673 WIDTH="80%"
674 ALIGN="LEFT"
675 VALIGN="TOP"
676 >  the entity content</TD
677 ></TR
678 ><TR
679 ><TD
680 WIDTH="20%"
681 ALIGN="RIGHT"
682 VALIGN="TOP"
683 ><SPAN
684 CLASS="emphasis"
685 ><I
686 CLASS="EMPHASIS"
687 >Returns</I
688 ></SPAN
689 > :</TD
690 ><TD
691 WIDTH="80%"
692 ALIGN="LEFT"
693 VALIGN="TOP"
694 >a pointer to the entity or NULL in case of error</TD
695 ></TR
696 ></TBODY
697 ></TABLE
698 ><P
699 ></P
700 ></DIV
701 ></DIV
702 ><HR><DIV
703 CLASS="REFSECT2"
704 ><A
705 NAME="AEN8257"
706 ></A
707 ><H3
708 ><A
709 NAME="XMLADDDTDENTITY"
710 ></A
711 >xmlAddDtdEntity ()</H3
712 ><TABLE
713 BORDER="0"
714 BGCOLOR="#D6E8FF"
715 WIDTH="100%"
716 CELLPADDING="6"
717 ><TR
718 ><TD
719 ><PRE
720 CLASS="PROGRAMLISTING"
721 ><A
722 HREF="libxml-tree.html#XMLENTITYPTR"
723 >xmlEntityPtr</A
724 > xmlAddDtdEntity                (<A
725 HREF="libxml-tree.html#XMLDOCPTR"
726 >xmlDocPtr</A
727 > doc,
728                                              const <A
729 HREF="libxml-tree.html#XMLCHAR"
730 >xmlChar</A
731 > *name,
732                                              int type,
733                                              const <A
734 HREF="libxml-tree.html#XMLCHAR"
735 >xmlChar</A
736 > *ExternalID,
737                                              const <A
738 HREF="libxml-tree.html#XMLCHAR"
739 >xmlChar</A
740 > *SystemID,
741                                              const <A
742 HREF="libxml-tree.html#XMLCHAR"
743 >xmlChar</A
744 > *content);</PRE
745 ></TD
746 ></TR
747 ></TABLE
748 ><P
749 >Register a new entity for this document DTD external subset.</P
750 ><P
751 ></P
752 ><DIV
753 CLASS="INFORMALTABLE"
754 ><A
755 NAME="AEN8269"><P
756 ></P
757 ><TABLE
758 BORDER="0"
759 WIDTH="100%"
760 BGCOLOR="#FFD0D0"
761 CELLSPACING="0"
762 CELLPADDING="4"
763 CLASS="CALSTABLE"
764 ><TBODY
765 ><TR
766 ><TD
767 WIDTH="20%"
768 ALIGN="RIGHT"
769 VALIGN="TOP"
770 ><TT
771 CLASS="PARAMETER"
772 ><I
773 >doc</I
774 ></TT
775 >&nbsp;:</TD
776 ><TD
777 WIDTH="80%"
778 ALIGN="LEFT"
779 VALIGN="TOP"
780 >  the document</TD
781 ></TR
782 ><TR
783 ><TD
784 WIDTH="20%"
785 ALIGN="RIGHT"
786 VALIGN="TOP"
787 ><TT
788 CLASS="PARAMETER"
789 ><I
790 >name</I
791 ></TT
792 >&nbsp;:</TD
793 ><TD
794 WIDTH="80%"
795 ALIGN="LEFT"
796 VALIGN="TOP"
797 >  the entity name</TD
798 ></TR
799 ><TR
800 ><TD
801 WIDTH="20%"
802 ALIGN="RIGHT"
803 VALIGN="TOP"
804 ><TT
805 CLASS="PARAMETER"
806 ><I
807 >type</I
808 ></TT
809 >&nbsp;:</TD
810 ><TD
811 WIDTH="80%"
812 ALIGN="LEFT"
813 VALIGN="TOP"
814 >  the entity type XML_xxx_yyy_ENTITY</TD
815 ></TR
816 ><TR
817 ><TD
818 WIDTH="20%"
819 ALIGN="RIGHT"
820 VALIGN="TOP"
821 ><TT
822 CLASS="PARAMETER"
823 ><I
824 >ExternalID</I
825 ></TT
826 >&nbsp;:</TD
827 ><TD
828 WIDTH="80%"
829 ALIGN="LEFT"
830 VALIGN="TOP"
831 >  the entity external ID if available</TD
832 ></TR
833 ><TR
834 ><TD
835 WIDTH="20%"
836 ALIGN="RIGHT"
837 VALIGN="TOP"
838 ><TT
839 CLASS="PARAMETER"
840 ><I
841 >SystemID</I
842 ></TT
843 >&nbsp;:</TD
844 ><TD
845 WIDTH="80%"
846 ALIGN="LEFT"
847 VALIGN="TOP"
848 >  the entity system ID if available</TD
849 ></TR
850 ><TR
851 ><TD
852 WIDTH="20%"
853 ALIGN="RIGHT"
854 VALIGN="TOP"
855 ><TT
856 CLASS="PARAMETER"
857 ><I
858 >content</I
859 ></TT
860 >&nbsp;:</TD
861 ><TD
862 WIDTH="80%"
863 ALIGN="LEFT"
864 VALIGN="TOP"
865 >  the entity content</TD
866 ></TR
867 ><TR
868 ><TD
869 WIDTH="20%"
870 ALIGN="RIGHT"
871 VALIGN="TOP"
872 ><SPAN
873 CLASS="emphasis"
874 ><I
875 CLASS="EMPHASIS"
876 >Returns</I
877 ></SPAN
878 > :</TD
879 ><TD
880 WIDTH="80%"
881 ALIGN="LEFT"
882 VALIGN="TOP"
883 >a pointer to the entity or NULL in case of error</TD
884 ></TR
885 ></TBODY
886 ></TABLE
887 ><P
888 ></P
889 ></DIV
890 ></DIV
891 ><HR><DIV
892 CLASS="REFSECT2"
893 ><A
894 NAME="AEN8302"
895 ></A
896 ><H3
897 ><A
898 NAME="XMLGETPREDEFINEDENTITY"
899 ></A
900 >xmlGetPredefinedEntity ()</H3
901 ><TABLE
902 BORDER="0"
903 BGCOLOR="#D6E8FF"
904 WIDTH="100%"
905 CELLPADDING="6"
906 ><TR
907 ><TD
908 ><PRE
909 CLASS="PROGRAMLISTING"
910 ><A
911 HREF="libxml-tree.html#XMLENTITYPTR"
912 >xmlEntityPtr</A
913 > xmlGetPredefinedEntity         (const <A
914 HREF="libxml-tree.html#XMLCHAR"
915 >xmlChar</A
916 > *name);</PRE
917 ></TD
918 ></TR
919 ></TABLE
920 ><P
921 >Check whether this name is an predefined entity.</P
922 ><P
923 ></P
924 ><DIV
925 CLASS="INFORMALTABLE"
926 ><A
927 NAME="AEN8310"><P
928 ></P
929 ><TABLE
930 BORDER="0"
931 WIDTH="100%"
932 BGCOLOR="#FFD0D0"
933 CELLSPACING="0"
934 CELLPADDING="4"
935 CLASS="CALSTABLE"
936 ><TBODY
937 ><TR
938 ><TD
939 WIDTH="20%"
940 ALIGN="RIGHT"
941 VALIGN="TOP"
942 ><TT
943 CLASS="PARAMETER"
944 ><I
945 >name</I
946 ></TT
947 >&nbsp;:</TD
948 ><TD
949 WIDTH="80%"
950 ALIGN="LEFT"
951 VALIGN="TOP"
952 >  the entity name</TD
953 ></TR
954 ><TR
955 ><TD
956 WIDTH="20%"
957 ALIGN="RIGHT"
958 VALIGN="TOP"
959 ><SPAN
960 CLASS="emphasis"
961 ><I
962 CLASS="EMPHASIS"
963 >Returns</I
964 ></SPAN
965 > :</TD
966 ><TD
967 WIDTH="80%"
968 ALIGN="LEFT"
969 VALIGN="TOP"
970 >NULL if not, otherwise the entity</TD
971 ></TR
972 ></TBODY
973 ></TABLE
974 ><P
975 ></P
976 ></DIV
977 ></DIV
978 ><HR><DIV
979 CLASS="REFSECT2"
980 ><A
981 NAME="AEN8323"
982 ></A
983 ><H3
984 ><A
985 NAME="XMLGETDOCENTITY"
986 ></A
987 >xmlGetDocEntity ()</H3
988 ><TABLE
989 BORDER="0"
990 BGCOLOR="#D6E8FF"
991 WIDTH="100%"
992 CELLPADDING="6"
993 ><TR
994 ><TD
995 ><PRE
996 CLASS="PROGRAMLISTING"
997 ><A
998 HREF="libxml-tree.html#XMLENTITYPTR"
999 >xmlEntityPtr</A
1000 > xmlGetDocEntity                (<A
1001 HREF="libxml-tree.html#XMLDOCPTR"
1002 >xmlDocPtr</A
1003 > doc,
1004                                              const <A
1005 HREF="libxml-tree.html#XMLCHAR"
1006 >xmlChar</A
1007 > *name);</PRE
1008 ></TD
1009 ></TR
1010 ></TABLE
1011 ><P
1012 >Do an entity lookup in the document entity hash table and
1013 returns the corresponding entity, otherwise a lookup is done
1014 in the predefined entities too.</P
1015 ><P
1016 ></P
1017 ><DIV
1018 CLASS="INFORMALTABLE"
1019 ><A
1020 NAME="AEN8332"><P
1021 ></P
1022 ><TABLE
1023 BORDER="0"
1024 WIDTH="100%"
1025 BGCOLOR="#FFD0D0"
1026 CELLSPACING="0"
1027 CELLPADDING="4"
1028 CLASS="CALSTABLE"
1029 ><TBODY
1030 ><TR
1031 ><TD
1032 WIDTH="20%"
1033 ALIGN="RIGHT"
1034 VALIGN="TOP"
1035 ><TT
1036 CLASS="PARAMETER"
1037 ><I
1038 >doc</I
1039 ></TT
1040 >&nbsp;:</TD
1041 ><TD
1042 WIDTH="80%"
1043 ALIGN="LEFT"
1044 VALIGN="TOP"
1045 >  the document referencing the entity</TD
1046 ></TR
1047 ><TR
1048 ><TD
1049 WIDTH="20%"
1050 ALIGN="RIGHT"
1051 VALIGN="TOP"
1052 ><TT
1053 CLASS="PARAMETER"
1054 ><I
1055 >name</I
1056 ></TT
1057 >&nbsp;:</TD
1058 ><TD
1059 WIDTH="80%"
1060 ALIGN="LEFT"
1061 VALIGN="TOP"
1062 >  the entity name</TD
1063 ></TR
1064 ><TR
1065 ><TD
1066 WIDTH="20%"
1067 ALIGN="RIGHT"
1068 VALIGN="TOP"
1069 ><SPAN
1070 CLASS="emphasis"
1071 ><I
1072 CLASS="EMPHASIS"
1073 >Returns</I
1074 ></SPAN
1075 > :</TD
1076 ><TD
1077 WIDTH="80%"
1078 ALIGN="LEFT"
1079 VALIGN="TOP"
1080 >A pointer to the entity structure or NULL if not found.</TD
1081 ></TR
1082 ></TBODY
1083 ></TABLE
1084 ><P
1085 ></P
1086 ></DIV
1087 ></DIV
1088 ><HR><DIV
1089 CLASS="REFSECT2"
1090 ><A
1091 NAME="AEN8349"
1092 ></A
1093 ><H3
1094 ><A
1095 NAME="XMLGETDTDENTITY"
1096 ></A
1097 >xmlGetDtdEntity ()</H3
1098 ><TABLE
1099 BORDER="0"
1100 BGCOLOR="#D6E8FF"
1101 WIDTH="100%"
1102 CELLPADDING="6"
1103 ><TR
1104 ><TD
1105 ><PRE
1106 CLASS="PROGRAMLISTING"
1107 ><A
1108 HREF="libxml-tree.html#XMLENTITYPTR"
1109 >xmlEntityPtr</A
1110 > xmlGetDtdEntity                (<A
1111 HREF="libxml-tree.html#XMLDOCPTR"
1112 >xmlDocPtr</A
1113 > doc,
1114                                              const <A
1115 HREF="libxml-tree.html#XMLCHAR"
1116 >xmlChar</A
1117 > *name);</PRE
1118 ></TD
1119 ></TR
1120 ></TABLE
1121 ><P
1122 >Do an entity lookup in the DTD entity hash table and
1123 returns the corresponding entity, if found.
1124 Note: the first argument is the document node, not the DTD node.</P
1125 ><P
1126 ></P
1127 ><DIV
1128 CLASS="INFORMALTABLE"
1129 ><A
1130 NAME="AEN8358"><P
1131 ></P
1132 ><TABLE
1133 BORDER="0"
1134 WIDTH="100%"
1135 BGCOLOR="#FFD0D0"
1136 CELLSPACING="0"
1137 CELLPADDING="4"
1138 CLASS="CALSTABLE"
1139 ><TBODY
1140 ><TR
1141 ><TD
1142 WIDTH="20%"
1143 ALIGN="RIGHT"
1144 VALIGN="TOP"
1145 ><TT
1146 CLASS="PARAMETER"
1147 ><I
1148 >doc</I
1149 ></TT
1150 >&nbsp;:</TD
1151 ><TD
1152 WIDTH="80%"
1153 ALIGN="LEFT"
1154 VALIGN="TOP"
1155 >  the document referencing the entity</TD
1156 ></TR
1157 ><TR
1158 ><TD
1159 WIDTH="20%"
1160 ALIGN="RIGHT"
1161 VALIGN="TOP"
1162 ><TT
1163 CLASS="PARAMETER"
1164 ><I
1165 >name</I
1166 ></TT
1167 >&nbsp;:</TD
1168 ><TD
1169 WIDTH="80%"
1170 ALIGN="LEFT"
1171 VALIGN="TOP"
1172 >  the entity name</TD
1173 ></TR
1174 ><TR
1175 ><TD
1176 WIDTH="20%"
1177 ALIGN="RIGHT"
1178 VALIGN="TOP"
1179 ><SPAN
1180 CLASS="emphasis"
1181 ><I
1182 CLASS="EMPHASIS"
1183 >Returns</I
1184 ></SPAN
1185 > :</TD
1186 ><TD
1187 WIDTH="80%"
1188 ALIGN="LEFT"
1189 VALIGN="TOP"
1190 >A pointer to the entity structure or NULL if not found.</TD
1191 ></TR
1192 ></TBODY
1193 ></TABLE
1194 ><P
1195 ></P
1196 ></DIV
1197 ></DIV
1198 ><HR><DIV
1199 CLASS="REFSECT2"
1200 ><A
1201 NAME="AEN8375"
1202 ></A
1203 ><H3
1204 ><A
1205 NAME="XMLGETPARAMETERENTITY"
1206 ></A
1207 >xmlGetParameterEntity ()</H3
1208 ><TABLE
1209 BORDER="0"
1210 BGCOLOR="#D6E8FF"
1211 WIDTH="100%"
1212 CELLPADDING="6"
1213 ><TR
1214 ><TD
1215 ><PRE
1216 CLASS="PROGRAMLISTING"
1217 ><A
1218 HREF="libxml-tree.html#XMLENTITYPTR"
1219 >xmlEntityPtr</A
1220 > xmlGetParameterEntity          (<A
1221 HREF="libxml-tree.html#XMLDOCPTR"
1222 >xmlDocPtr</A
1223 > doc,
1224                                              const <A
1225 HREF="libxml-tree.html#XMLCHAR"
1226 >xmlChar</A
1227 > *name);</PRE
1228 ></TD
1229 ></TR
1230 ></TABLE
1231 ><P
1232 >Do an entity lookup in the internal and external subsets and
1233 returns the corresponding parameter entity, if found.</P
1234 ><P
1235 ></P
1236 ><DIV
1237 CLASS="INFORMALTABLE"
1238 ><A
1239 NAME="AEN8384"><P
1240 ></P
1241 ><TABLE
1242 BORDER="0"
1243 WIDTH="100%"
1244 BGCOLOR="#FFD0D0"
1245 CELLSPACING="0"
1246 CELLPADDING="4"
1247 CLASS="CALSTABLE"
1248 ><TBODY
1249 ><TR
1250 ><TD
1251 WIDTH="20%"
1252 ALIGN="RIGHT"
1253 VALIGN="TOP"
1254 ><TT
1255 CLASS="PARAMETER"
1256 ><I
1257 >doc</I
1258 ></TT
1259 >&nbsp;:</TD
1260 ><TD
1261 WIDTH="80%"
1262 ALIGN="LEFT"
1263 VALIGN="TOP"
1264 >  the document referencing the entity</TD
1265 ></TR
1266 ><TR
1267 ><TD
1268 WIDTH="20%"
1269 ALIGN="RIGHT"
1270 VALIGN="TOP"
1271 ><TT
1272 CLASS="PARAMETER"
1273 ><I
1274 >name</I
1275 ></TT
1276 >&nbsp;:</TD
1277 ><TD
1278 WIDTH="80%"
1279 ALIGN="LEFT"
1280 VALIGN="TOP"
1281 >  the entity name</TD
1282 ></TR
1283 ><TR
1284 ><TD
1285 WIDTH="20%"
1286 ALIGN="RIGHT"
1287 VALIGN="TOP"
1288 ><SPAN
1289 CLASS="emphasis"
1290 ><I
1291 CLASS="EMPHASIS"
1292 >Returns</I
1293 ></SPAN
1294 > :</TD
1295 ><TD
1296 WIDTH="80%"
1297 ALIGN="LEFT"
1298 VALIGN="TOP"
1299 >A pointer to the entity structure or NULL if not found.</TD
1300 ></TR
1301 ></TBODY
1302 ></TABLE
1303 ><P
1304 ></P
1305 ></DIV
1306 ></DIV
1307 ><HR><DIV
1308 CLASS="REFSECT2"
1309 ><A
1310 NAME="AEN8401"
1311 ></A
1312 ><H3
1313 ><A
1314 NAME="XMLENCODEENTITIES"
1315 ></A
1316 >xmlEncodeEntities ()</H3
1317 ><TABLE
1318 BORDER="0"
1319 BGCOLOR="#D6E8FF"
1320 WIDTH="100%"
1321 CELLPADDING="6"
1322 ><TR
1323 ><TD
1324 ><PRE
1325 CLASS="PROGRAMLISTING"
1326 >const <A
1327 HREF="libxml-tree.html#XMLCHAR"
1328 >xmlChar</A
1329 >* xmlEncodeEntities            (<A
1330 HREF="libxml-tree.html#XMLDOCPTR"
1331 >xmlDocPtr</A
1332 > doc,
1333                                              const <A
1334 HREF="libxml-tree.html#XMLCHAR"
1335 >xmlChar</A
1336 > *input);</PRE
1337 ></TD
1338 ></TR
1339 ></TABLE
1340 ><P
1341 >Do a global encoding of a string, replacing the predefined entities
1342 and non ASCII values with their entities and CharRef counterparts.</P
1343 ><P
1344 >TODO: remove xmlEncodeEntities, once we are not afraid of breaking binary
1345 compatibility</P
1346 ><P
1347 >People must migrate their code to xmlEncodeEntitiesReentrant !
1348 This routine will issue a warning when encountered.</P
1349 ><P
1350 ></P
1351 ><DIV
1352 CLASS="INFORMALTABLE"
1353 ><A
1354 NAME="AEN8412"><P
1355 ></P
1356 ><TABLE
1357 BORDER="0"
1358 WIDTH="100%"
1359 BGCOLOR="#FFD0D0"
1360 CELLSPACING="0"
1361 CELLPADDING="4"
1362 CLASS="CALSTABLE"
1363 ><TBODY
1364 ><TR
1365 ><TD
1366 WIDTH="20%"
1367 ALIGN="RIGHT"
1368 VALIGN="TOP"
1369 ><TT
1370 CLASS="PARAMETER"
1371 ><I
1372 >doc</I
1373 ></TT
1374 >&nbsp;:</TD
1375 ><TD
1376 WIDTH="80%"
1377 ALIGN="LEFT"
1378 VALIGN="TOP"
1379 >  the document containing the string</TD
1380 ></TR
1381 ><TR
1382 ><TD
1383 WIDTH="20%"
1384 ALIGN="RIGHT"
1385 VALIGN="TOP"
1386 ><TT
1387 CLASS="PARAMETER"
1388 ><I
1389 >input</I
1390 ></TT
1391 >&nbsp;:</TD
1392 ><TD
1393 WIDTH="80%"
1394 ALIGN="LEFT"
1395 VALIGN="TOP"
1396 >  A string to convert to XML.</TD
1397 ></TR
1398 ><TR
1399 ><TD
1400 WIDTH="20%"
1401 ALIGN="RIGHT"
1402 VALIGN="TOP"
1403 ><SPAN
1404 CLASS="emphasis"
1405 ><I
1406 CLASS="EMPHASIS"
1407 >Returns</I
1408 ></SPAN
1409 > :</TD
1410 ><TD
1411 WIDTH="80%"
1412 ALIGN="LEFT"
1413 VALIGN="TOP"
1414 >A newly allocated string with the substitution done.</TD
1415 ></TR
1416 ></TBODY
1417 ></TABLE
1418 ><P
1419 ></P
1420 ></DIV
1421 ></DIV
1422 ><HR><DIV
1423 CLASS="REFSECT2"
1424 ><A
1425 NAME="AEN8429"
1426 ></A
1427 ><H3
1428 ><A
1429 NAME="XMLENCODEENTITIESREENTRANT"
1430 ></A
1431 >xmlEncodeEntitiesReentrant ()</H3
1432 ><TABLE
1433 BORDER="0"
1434 BGCOLOR="#D6E8FF"
1435 WIDTH="100%"
1436 CELLPADDING="6"
1437 ><TR
1438 ><TD
1439 ><PRE
1440 CLASS="PROGRAMLISTING"
1441 ><A
1442 HREF="libxml-tree.html#XMLCHAR"
1443 >xmlChar</A
1444 >*    xmlEncodeEntitiesReentrant      (<A
1445 HREF="libxml-tree.html#XMLDOCPTR"
1446 >xmlDocPtr</A
1447 > doc,
1448                                              const <A
1449 HREF="libxml-tree.html#XMLCHAR"
1450 >xmlChar</A
1451 > *input);</PRE
1452 ></TD
1453 ></TR
1454 ></TABLE
1455 ><P
1456 >Do a global encoding of a string, replacing the predefined entities
1457 and non ASCII values with their entities and CharRef counterparts.
1458 Contrary to xmlEncodeEntities, this routine is reentrant, and result
1459 must be deallocated.</P
1460 ><P
1461 ></P
1462 ><DIV
1463 CLASS="INFORMALTABLE"
1464 ><A
1465 NAME="AEN8438"><P
1466 ></P
1467 ><TABLE
1468 BORDER="0"
1469 WIDTH="100%"
1470 BGCOLOR="#FFD0D0"
1471 CELLSPACING="0"
1472 CELLPADDING="4"
1473 CLASS="CALSTABLE"
1474 ><TBODY
1475 ><TR
1476 ><TD
1477 WIDTH="20%"
1478 ALIGN="RIGHT"
1479 VALIGN="TOP"
1480 ><TT
1481 CLASS="PARAMETER"
1482 ><I
1483 >doc</I
1484 ></TT
1485 >&nbsp;:</TD
1486 ><TD
1487 WIDTH="80%"
1488 ALIGN="LEFT"
1489 VALIGN="TOP"
1490 >  the document containing the string</TD
1491 ></TR
1492 ><TR
1493 ><TD
1494 WIDTH="20%"
1495 ALIGN="RIGHT"
1496 VALIGN="TOP"
1497 ><TT
1498 CLASS="PARAMETER"
1499 ><I
1500 >input</I
1501 ></TT
1502 >&nbsp;:</TD
1503 ><TD
1504 WIDTH="80%"
1505 ALIGN="LEFT"
1506 VALIGN="TOP"
1507 >  A string to convert to XML.</TD
1508 ></TR
1509 ><TR
1510 ><TD
1511 WIDTH="20%"
1512 ALIGN="RIGHT"
1513 VALIGN="TOP"
1514 ><SPAN
1515 CLASS="emphasis"
1516 ><I
1517 CLASS="EMPHASIS"
1518 >Returns</I
1519 ></SPAN
1520 > :</TD
1521 ><TD
1522 WIDTH="80%"
1523 ALIGN="LEFT"
1524 VALIGN="TOP"
1525 >A newly allocated string with the substitution done.</TD
1526 ></TR
1527 ></TBODY
1528 ></TABLE
1529 ><P
1530 ></P
1531 ></DIV
1532 ></DIV
1533 ><HR><DIV
1534 CLASS="REFSECT2"
1535 ><A
1536 NAME="AEN8455"
1537 ></A
1538 ><H3
1539 ><A
1540 NAME="XMLENCODESPECIALCHARS"
1541 ></A
1542 >xmlEncodeSpecialChars ()</H3
1543 ><TABLE
1544 BORDER="0"
1545 BGCOLOR="#D6E8FF"
1546 WIDTH="100%"
1547 CELLPADDING="6"
1548 ><TR
1549 ><TD
1550 ><PRE
1551 CLASS="PROGRAMLISTING"
1552 ><A
1553 HREF="libxml-tree.html#XMLCHAR"
1554 >xmlChar</A
1555 >*    xmlEncodeSpecialChars           (<A
1556 HREF="libxml-tree.html#XMLDOCPTR"
1557 >xmlDocPtr</A
1558 > doc,
1559                                              const <A
1560 HREF="libxml-tree.html#XMLCHAR"
1561 >xmlChar</A
1562 > *input);</PRE
1563 ></TD
1564 ></TR
1565 ></TABLE
1566 ><P
1567 >Do a global encoding of a string, replacing the predefined entities
1568 this routine is reentrant, and result must be deallocated.</P
1569 ><P
1570 ></P
1571 ><DIV
1572 CLASS="INFORMALTABLE"
1573 ><A
1574 NAME="AEN8464"><P
1575 ></P
1576 ><TABLE
1577 BORDER="0"
1578 WIDTH="100%"
1579 BGCOLOR="#FFD0D0"
1580 CELLSPACING="0"
1581 CELLPADDING="4"
1582 CLASS="CALSTABLE"
1583 ><TBODY
1584 ><TR
1585 ><TD
1586 WIDTH="20%"
1587 ALIGN="RIGHT"
1588 VALIGN="TOP"
1589 ><TT
1590 CLASS="PARAMETER"
1591 ><I
1592 >doc</I
1593 ></TT
1594 >&nbsp;:</TD
1595 ><TD
1596 WIDTH="80%"
1597 ALIGN="LEFT"
1598 VALIGN="TOP"
1599 >  the document containing the string</TD
1600 ></TR
1601 ><TR
1602 ><TD
1603 WIDTH="20%"
1604 ALIGN="RIGHT"
1605 VALIGN="TOP"
1606 ><TT
1607 CLASS="PARAMETER"
1608 ><I
1609 >input</I
1610 ></TT
1611 >&nbsp;:</TD
1612 ><TD
1613 WIDTH="80%"
1614 ALIGN="LEFT"
1615 VALIGN="TOP"
1616 >  A string to convert to XML.</TD
1617 ></TR
1618 ><TR
1619 ><TD
1620 WIDTH="20%"
1621 ALIGN="RIGHT"
1622 VALIGN="TOP"
1623 ><SPAN
1624 CLASS="emphasis"
1625 ><I
1626 CLASS="EMPHASIS"
1627 >Returns</I
1628 ></SPAN
1629 > :</TD
1630 ><TD
1631 WIDTH="80%"
1632 ALIGN="LEFT"
1633 VALIGN="TOP"
1634 >A newly allocated string with the substitution done.</TD
1635 ></TR
1636 ></TBODY
1637 ></TABLE
1638 ><P
1639 ></P
1640 ></DIV
1641 ></DIV
1642 ><HR><DIV
1643 CLASS="REFSECT2"
1644 ><A
1645 NAME="AEN8481"
1646 ></A
1647 ><H3
1648 ><A
1649 NAME="XMLCREATEENTITIESTABLE"
1650 ></A
1651 >xmlCreateEntitiesTable ()</H3
1652 ><TABLE
1653 BORDER="0"
1654 BGCOLOR="#D6E8FF"
1655 WIDTH="100%"
1656 CELLPADDING="6"
1657 ><TR
1658 ><TD
1659 ><PRE
1660 CLASS="PROGRAMLISTING"
1661 ><A
1662 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
1663 >xmlEntitiesTablePtr</A
1664 > xmlCreateEntitiesTable  (void);</PRE
1665 ></TD
1666 ></TR
1667 ></TABLE
1668 ><P
1669 >create and initialize an empty entities hash table.</P
1670 ><P
1671 ></P
1672 ><DIV
1673 CLASS="INFORMALTABLE"
1674 ><A
1675 NAME="AEN8488"><P
1676 ></P
1677 ><TABLE
1678 BORDER="0"
1679 WIDTH="100%"
1680 BGCOLOR="#FFD0D0"
1681 CELLSPACING="0"
1682 CELLPADDING="4"
1683 CLASS="CALSTABLE"
1684 ><TBODY
1685 ><TR
1686 ><TD
1687 WIDTH="20%"
1688 ALIGN="RIGHT"
1689 VALIGN="TOP"
1690 ><SPAN
1691 CLASS="emphasis"
1692 ><I
1693 CLASS="EMPHASIS"
1694 >Returns</I
1695 ></SPAN
1696 > :</TD
1697 ><TD
1698 WIDTH="80%"
1699 ALIGN="LEFT"
1700 VALIGN="TOP"
1701 >the xmlEntitiesTablePtr just created or NULL in case of error.</TD
1702 ></TR
1703 ></TBODY
1704 ></TABLE
1705 ><P
1706 ></P
1707 ></DIV
1708 ></DIV
1709 ><HR><DIV
1710 CLASS="REFSECT2"
1711 ><A
1712 NAME="AEN8497"
1713 ></A
1714 ><H3
1715 ><A
1716 NAME="XMLCOPYENTITIESTABLE"
1717 ></A
1718 >xmlCopyEntitiesTable ()</H3
1719 ><TABLE
1720 BORDER="0"
1721 BGCOLOR="#D6E8FF"
1722 WIDTH="100%"
1723 CELLPADDING="6"
1724 ><TR
1725 ><TD
1726 ><PRE
1727 CLASS="PROGRAMLISTING"
1728 ><A
1729 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
1730 >xmlEntitiesTablePtr</A
1731 > xmlCopyEntitiesTable    (<A
1732 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
1733 >xmlEntitiesTablePtr</A
1734 > table);</PRE
1735 ></TD
1736 ></TR
1737 ></TABLE
1738 ><P
1739 >Build a copy of an entity table.</P
1740 ><P
1741 ></P
1742 ><DIV
1743 CLASS="INFORMALTABLE"
1744 ><A
1745 NAME="AEN8505"><P
1746 ></P
1747 ><TABLE
1748 BORDER="0"
1749 WIDTH="100%"
1750 BGCOLOR="#FFD0D0"
1751 CELLSPACING="0"
1752 CELLPADDING="4"
1753 CLASS="CALSTABLE"
1754 ><TBODY
1755 ><TR
1756 ><TD
1757 WIDTH="20%"
1758 ALIGN="RIGHT"
1759 VALIGN="TOP"
1760 ><TT
1761 CLASS="PARAMETER"
1762 ><I
1763 >table</I
1764 ></TT
1765 >&nbsp;:</TD
1766 ><TD
1767 WIDTH="80%"
1768 ALIGN="LEFT"
1769 VALIGN="TOP"
1770 >  An entity table</TD
1771 ></TR
1772 ><TR
1773 ><TD
1774 WIDTH="20%"
1775 ALIGN="RIGHT"
1776 VALIGN="TOP"
1777 ><SPAN
1778 CLASS="emphasis"
1779 ><I
1780 CLASS="EMPHASIS"
1781 >Returns</I
1782 ></SPAN
1783 > :</TD
1784 ><TD
1785 WIDTH="80%"
1786 ALIGN="LEFT"
1787 VALIGN="TOP"
1788 >the new xmlEntitiesTablePtr or NULL in case of error.</TD
1789 ></TR
1790 ></TBODY
1791 ></TABLE
1792 ><P
1793 ></P
1794 ></DIV
1795 ></DIV
1796 ><HR><DIV
1797 CLASS="REFSECT2"
1798 ><A
1799 NAME="AEN8518"
1800 ></A
1801 ><H3
1802 ><A
1803 NAME="XMLFREEENTITIESTABLE"
1804 ></A
1805 >xmlFreeEntitiesTable ()</H3
1806 ><TABLE
1807 BORDER="0"
1808 BGCOLOR="#D6E8FF"
1809 WIDTH="100%"
1810 CELLPADDING="6"
1811 ><TR
1812 ><TD
1813 ><PRE
1814 CLASS="PROGRAMLISTING"
1815 >void        xmlFreeEntitiesTable            (<A
1816 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
1817 >xmlEntitiesTablePtr</A
1818 > table);</PRE
1819 ></TD
1820 ></TR
1821 ></TABLE
1822 ><P
1823 >Deallocate the memory used by an entities hash table.</P
1824 ><P
1825 ></P
1826 ><DIV
1827 CLASS="INFORMALTABLE"
1828 ><A
1829 NAME="AEN8525"><P
1830 ></P
1831 ><TABLE
1832 BORDER="0"
1833 WIDTH="100%"
1834 BGCOLOR="#FFD0D0"
1835 CELLSPACING="0"
1836 CELLPADDING="4"
1837 CLASS="CALSTABLE"
1838 ><TBODY
1839 ><TR
1840 ><TD
1841 WIDTH="20%"
1842 ALIGN="RIGHT"
1843 VALIGN="TOP"
1844 ><TT
1845 CLASS="PARAMETER"
1846 ><I
1847 >table</I
1848 ></TT
1849 >&nbsp;:</TD
1850 ><TD
1851 WIDTH="80%"
1852 ALIGN="LEFT"
1853 VALIGN="TOP"
1854 >  An entity table</TD
1855 ></TR
1856 ></TBODY
1857 ></TABLE
1858 ><P
1859 ></P
1860 ></DIV
1861 ></DIV
1862 ><HR><DIV
1863 CLASS="REFSECT2"
1864 ><A
1865 NAME="AEN8534"
1866 ></A
1867 ><H3
1868 ><A
1869 NAME="XMLDUMPENTITIESTABLE"
1870 ></A
1871 >xmlDumpEntitiesTable ()</H3
1872 ><TABLE
1873 BORDER="0"
1874 BGCOLOR="#D6E8FF"
1875 WIDTH="100%"
1876 CELLPADDING="6"
1877 ><TR
1878 ><TD
1879 ><PRE
1880 CLASS="PROGRAMLISTING"
1881 >void        xmlDumpEntitiesTable            (<A
1882 HREF="libxml-tree.html#XMLBUFFERPTR"
1883 >xmlBufferPtr</A
1884 > buf,
1885                                              <A
1886 HREF="libxml-entities.html#XMLENTITIESTABLEPTR"
1887 >xmlEntitiesTablePtr</A
1888 > table);</PRE
1889 ></TD
1890 ></TR
1891 ></TABLE
1892 ><P
1893 >This will dump the content of the entity table as an XML DTD definition</P
1894 ><P
1895 ></P
1896 ><DIV
1897 CLASS="INFORMALTABLE"
1898 ><A
1899 NAME="AEN8542"><P
1900 ></P
1901 ><TABLE
1902 BORDER="0"
1903 WIDTH="100%"
1904 BGCOLOR="#FFD0D0"
1905 CELLSPACING="0"
1906 CELLPADDING="4"
1907 CLASS="CALSTABLE"
1908 ><TBODY
1909 ><TR
1910 ><TD
1911 WIDTH="20%"
1912 ALIGN="RIGHT"
1913 VALIGN="TOP"
1914 ><TT
1915 CLASS="PARAMETER"
1916 ><I
1917 >buf</I
1918 ></TT
1919 >&nbsp;:</TD
1920 ><TD
1921 WIDTH="80%"
1922 ALIGN="LEFT"
1923 VALIGN="TOP"
1924 >  An XML buffer.</TD
1925 ></TR
1926 ><TR
1927 ><TD
1928 WIDTH="20%"
1929 ALIGN="RIGHT"
1930 VALIGN="TOP"
1931 ><TT
1932 CLASS="PARAMETER"
1933 ><I
1934 >table</I
1935 ></TT
1936 >&nbsp;:</TD
1937 ><TD
1938 WIDTH="80%"
1939 ALIGN="LEFT"
1940 VALIGN="TOP"
1941 >  An entity table</TD
1942 ></TR
1943 ></TBODY
1944 ></TABLE
1945 ><P
1946 ></P
1947 ></DIV
1948 ></DIV
1949 ><HR><DIV
1950 CLASS="REFSECT2"
1951 ><A
1952 NAME="AEN8555"
1953 ></A
1954 ><H3
1955 ><A
1956 NAME="XMLDUMPENTITYDECL"
1957 ></A
1958 >xmlDumpEntityDecl ()</H3
1959 ><TABLE
1960 BORDER="0"
1961 BGCOLOR="#D6E8FF"
1962 WIDTH="100%"
1963 CELLPADDING="6"
1964 ><TR
1965 ><TD
1966 ><PRE
1967 CLASS="PROGRAMLISTING"
1968 >void        xmlDumpEntityDecl               (<A
1969 HREF="libxml-tree.html#XMLBUFFERPTR"
1970 >xmlBufferPtr</A
1971 > buf,
1972                                              <A
1973 HREF="libxml-tree.html#XMLENTITYPTR"
1974 >xmlEntityPtr</A
1975 > ent);</PRE
1976 ></TD
1977 ></TR
1978 ></TABLE
1979 ><P
1980 >This will dump the content of the entity table as an XML DTD definition</P
1981 ><P
1982 ></P
1983 ><DIV
1984 CLASS="INFORMALTABLE"
1985 ><A
1986 NAME="AEN8563"><P
1987 ></P
1988 ><TABLE
1989 BORDER="0"
1990 WIDTH="100%"
1991 BGCOLOR="#FFD0D0"
1992 CELLSPACING="0"
1993 CELLPADDING="4"
1994 CLASS="CALSTABLE"
1995 ><TBODY
1996 ><TR
1997 ><TD
1998 WIDTH="20%"
1999 ALIGN="RIGHT"
2000 VALIGN="TOP"
2001 ><TT
2002 CLASS="PARAMETER"
2003 ><I
2004 >buf</I
2005 ></TT
2006 >&nbsp;:</TD
2007 ><TD
2008 WIDTH="80%"
2009 ALIGN="LEFT"
2010 VALIGN="TOP"
2011 >  An XML buffer.</TD
2012 ></TR
2013 ><TR
2014 ><TD
2015 WIDTH="20%"
2016 ALIGN="RIGHT"
2017 VALIGN="TOP"
2018 ><TT
2019 CLASS="PARAMETER"
2020 ><I
2021 >ent</I
2022 ></TT
2023 >&nbsp;:</TD
2024 ><TD
2025 WIDTH="80%"
2026 ALIGN="LEFT"
2027 VALIGN="TOP"
2028 >  An entity table</TD
2029 ></TR
2030 ></TBODY
2031 ></TABLE
2032 ><P
2033 ></P
2034 ></DIV
2035 ></DIV
2036 ><HR><DIV
2037 CLASS="REFSECT2"
2038 ><A
2039 NAME="AEN8576"
2040 ></A
2041 ><H3
2042 ><A
2043 NAME="XMLCLEANUPPREDEFINEDENTITIES"
2044 ></A
2045 >xmlCleanupPredefinedEntities ()</H3
2046 ><TABLE
2047 BORDER="0"
2048 BGCOLOR="#D6E8FF"
2049 WIDTH="100%"
2050 CELLPADDING="6"
2051 ><TR
2052 ><TD
2053 ><PRE
2054 CLASS="PROGRAMLISTING"
2055 >void        xmlCleanupPredefinedEntities    (void);</PRE
2056 ></TD
2057 ></TR
2058 ></TABLE
2059 ><P
2060 >Cleanup up the predefined entities table.</P
2061 ><P
2062 ></P
2063 ></DIV
2064 ></DIV
2065 ><DIV
2066 CLASS="NAVFOOTER"
2067 ><BR
2068 CLEAR="all"><BR><TABLE
2069 WIDTH="100%"
2070 BORDER="0"
2071 BGCOLOR="#000000"
2072 CELLPADDING="1"
2073 CELLSPACING="0"
2074 ><TR
2075 ><TD
2076 WIDTH="25%"
2077 BGCOLOR="#C00000"
2078 ALIGN="left"
2079 ><A
2080 HREF="libxml-tree.html"
2081 ><FONT
2082 COLOR="#FFFFFF"
2083 SIZE="3"
2084 ><B
2085 >&#60;&#60;&#60; Previous Page</B
2086 ></FONT
2087 ></A
2088 ></TD
2089 ><TD
2090 WIDTH="25%"
2091 BGCOLOR="#0000C0"
2092 ALIGN="center"
2093 ><FONT
2094 COLOR="#FFFFFF"
2095 SIZE="3"
2096 ><B
2097 ><A
2098 HREF="book1.html"
2099 ><FONT
2100 COLOR="#FFFFFF"
2101 SIZE="3"
2102 ><B
2103 >Home</B
2104 ></FONT
2105 ></A
2106 ></B
2107 ></FONT
2108 ></TD
2109 ><TD
2110 WIDTH="25%"
2111 BGCOLOR="#00C000"
2112 ALIGN="center"
2113 ><FONT
2114 COLOR="#FFFFFF"
2115 SIZE="3"
2116 ><B
2117 ><A
2118 HREF="libxml-lib.html"
2119 ><FONT
2120 COLOR="#FFFFFF"
2121 SIZE="3"
2122 ><B
2123 >Up</B
2124 ></FONT
2125 ></A
2126 ></B
2127 ></FONT
2128 ></TD
2129 ><TD
2130 WIDTH="25%"
2131 BGCOLOR="#C00000"
2132 ALIGN="right"
2133 ><A
2134 HREF="libxml-valid.html"
2135 ><FONT
2136 COLOR="#FFFFFF"
2137 SIZE="3"
2138 ><B
2139 >Next Page &#62;&#62;&#62;</B
2140 ></FONT
2141 ></A
2142 ></TD
2143 ></TR
2144 ><TR
2145 ><TD
2146 COLSPAN="2"
2147 ALIGN="left"
2148 ><FONT
2149 COLOR="#FFFFFF"
2150 SIZE="3"
2151 ><B
2152 >tree</B
2153 ></FONT
2154 ></TD
2155 ><TD
2156 COLSPAN="2"
2157 ALIGN="right"
2158 ><FONT
2159 COLOR="#FFFFFF"
2160 SIZE="3"
2161 ><B
2162 >valid</B
2163 ></FONT
2164 ></TD
2165 ></TR
2166 ></TABLE
2167 ></DIV
2168 ></BODY
2169 ></HTML
2170 >