mirror of
https://github.com/GNOME/libxml2.git
synced 2025-02-23 18:29:14 +08:00
2158 lines
31 KiB
HTML
2158 lines
31 KiB
HTML
<HTML
|
|
><HEAD
|
|
><TITLE
|
|
>entities</TITLE
|
|
><META
|
|
NAME="GENERATOR"
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.33"><LINK
|
|
REL="HOME"
|
|
TITLE="Gnome XML Library Reference Manual"
|
|
HREF="book1.html"><LINK
|
|
REL="UP"
|
|
TITLE="Libxml Library Reference"
|
|
HREF="libxml-lib.html"><LINK
|
|
REL="PREVIOUS"
|
|
TITLE="tree"
|
|
HREF="gnome-xml-tree.html"><LINK
|
|
REL="NEXT"
|
|
TITLE="valid"
|
|
HREF="gnome-xml-valid.html"></HEAD
|
|
><BODY
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
><DIV
|
|
CLASS="NAVHEADER"
|
|
><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
BGCOLOR="#000000"
|
|
CELLPADDING="1"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TH
|
|
COLSPAN="4"
|
|
ALIGN="center"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="5"
|
|
>Gnome XML Library Reference Manual</FONT
|
|
></TH
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="25%"
|
|
BGCOLOR="#C00000"
|
|
ALIGN="left"
|
|
><A
|
|
HREF="gnome-xml-tree.html"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
><<< Previous Page</B
|
|
></FONT
|
|
></A
|
|
></TD
|
|
><TD
|
|
WIDTH="25%"
|
|
BGCOLOR="#0000C0"
|
|
ALIGN="center"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
><A
|
|
HREF="book1.html"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
>Home</B
|
|
></FONT
|
|
></A
|
|
></B
|
|
></FONT
|
|
></TD
|
|
><TD
|
|
WIDTH="25%"
|
|
BGCOLOR="#00C000"
|
|
ALIGN="center"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
><A
|
|
HREF="libxml-lib.html"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
>Up</B
|
|
></FONT
|
|
></A
|
|
></B
|
|
></FONT
|
|
></TD
|
|
><TD
|
|
WIDTH="25%"
|
|
BGCOLOR="#C00000"
|
|
ALIGN="right"
|
|
><A
|
|
HREF="gnome-xml-valid.html"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
>Next Page >>></B
|
|
></FONT
|
|
></A
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><H1
|
|
>entities</H1
|
|
><DIV
|
|
CLASS="REFNAMEDIV"
|
|
><A
|
|
NAME="AEN6147"
|
|
></A
|
|
><H2
|
|
>Name</H2
|
|
>entities — </DIV
|
|
><DIV
|
|
CLASS="REFSYNOPSISDIV"
|
|
><A
|
|
NAME="AEN6150"
|
|
></A
|
|
><H2
|
|
>Synopsis</H2
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="SYNOPSIS"
|
|
>
|
|
|
|
enum <A
|
|
HREF="gnome-xml-entities.html#XMLENTITYTYPE"
|
|
>xmlEntityType</A
|
|
>;
|
|
struct <A
|
|
HREF="gnome-xml-entities.html#XMLENTITY"
|
|
>xmlEntity</A
|
|
>;
|
|
typedef <A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
>;
|
|
#define <A
|
|
HREF="gnome-xml-entities.html#XML-MIN-ENTITIES-TABLE"
|
|
>XML_MIN_ENTITIES_TABLE</A
|
|
>
|
|
struct <A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLE"
|
|
>xmlEntitiesTable</A
|
|
>;
|
|
typedef <A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
>;
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> <A
|
|
HREF="gnome-xml-entities.html#XMLADDDOCENTITY"
|
|
>xmlAddDocEntity</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name,
|
|
int type,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *ExternalID,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *SystemID,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *content);
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> <A
|
|
HREF="gnome-xml-entities.html#XMLADDDTDENTITY"
|
|
>xmlAddDtdEntity</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name,
|
|
int type,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *ExternalID,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *SystemID,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *content);
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> <A
|
|
HREF="gnome-xml-entities.html#XMLGETPREDEFINEDENTITY"
|
|
>xmlGetPredefinedEntity</A
|
|
> (const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name);
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> <A
|
|
HREF="gnome-xml-entities.html#XMLGETDOCENTITY"
|
|
>xmlGetDocEntity</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name);
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> <A
|
|
HREF="gnome-xml-entities.html#XMLGETDTDENTITY"
|
|
>xmlGetDtdEntity</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name);
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> <A
|
|
HREF="gnome-xml-entities.html#XMLGETPARAMETERENTITY"
|
|
>xmlGetParameterEntity</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name);
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
>* <A
|
|
HREF="gnome-xml-entities.html#XMLENCODEENTITIES"
|
|
>xmlEncodeEntities</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *input);
|
|
<A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
>* <A
|
|
HREF="gnome-xml-entities.html#XMLENCODEENTITIESREENTRANT"
|
|
>xmlEncodeEntitiesReentrant</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *input);
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> <A
|
|
HREF="gnome-xml-entities.html#XMLCREATEENTITIESTABLE"
|
|
>xmlCreateEntitiesTable</A
|
|
> (void);
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> <A
|
|
HREF="gnome-xml-entities.html#XMLCOPYENTITIESTABLE"
|
|
>xmlCopyEntitiesTable</A
|
|
> (<A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> table);
|
|
void <A
|
|
HREF="gnome-xml-entities.html#XMLFREEENTITIESTABLE"
|
|
>xmlFreeEntitiesTable</A
|
|
> (<A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> table);
|
|
void <A
|
|
HREF="gnome-xml-entities.html#XMLDUMPENTITIESTABLE"
|
|
>xmlDumpEntitiesTable</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLBUFFERPTR"
|
|
>xmlBufferPtr</A
|
|
> buf,
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> table);
|
|
void <A
|
|
HREF="gnome-xml-entities.html#XMLDUMPENTITYDECL"
|
|
>xmlDumpEntityDecl</A
|
|
> (<A
|
|
HREF="gnome-xml-tree.html#XMLBUFFERPTR"
|
|
>xmlBufferPtr</A
|
|
> buf,
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> ent);
|
|
void <A
|
|
HREF="gnome-xml-entities.html#XMLCLEANUPPREDEFINEDENTITIES"
|
|
>xmlCleanupPredefinedEntities</A
|
|
> (void);
|
|
int <A
|
|
HREF="gnome-xml-entities.html#XMLENTITYADDREFERENCE"
|
|
>xmlEntityAddReference</A
|
|
> (<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> ent,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *to);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN6213"
|
|
></A
|
|
><H2
|
|
>Description</H2
|
|
><P
|
|
></P
|
|
></DIV
|
|
><DIV
|
|
CLASS="REFSECT1"
|
|
><A
|
|
NAME="AEN6216"
|
|
></A
|
|
><H2
|
|
>Details</H2
|
|
><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6218"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLENTITYTYPE"
|
|
></A
|
|
>enum xmlEntityType</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>typedef enum {
|
|
XML_INTERNAL_GENERAL_ENTITY = 1,
|
|
XML_EXTERNAL_GENERAL_PARSED_ENTITY = 2,
|
|
XML_EXTERNAL_GENERAL_UNPARSED_ENTITY = 3,
|
|
XML_INTERNAL_PARAMETER_ENTITY = 4,
|
|
XML_EXTERNAL_PARAMETER_ENTITY = 5,
|
|
XML_INTERNAL_PREDEFINED_ENTITY = 6
|
|
} xmlEntityType;</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6223"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLENTITY"
|
|
></A
|
|
>struct xmlEntity</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>struct xmlEntity {
|
|
#ifndef XML_WITHOUT_CORBA
|
|
void *_private; /* for Corba, must be first ! */
|
|
#endif
|
|
xmlElementType type; /* XML_ENTITY_DECL, must be second ! */
|
|
const xmlChar *name; /* Attribute name */
|
|
struct _xmlNode *children; /* NULL */
|
|
struct _xmlNode *last; /* NULL */
|
|
struct _xmlDtd *parent; /* -> DTD */
|
|
struct _xmlNode *next; /* next sibling link */
|
|
struct _xmlNode *prev; /* previous sibling link */
|
|
struct _xmlDoc *doc; /* the containing document */
|
|
|
|
xmlChar *orig; /* content without ref substitution */
|
|
xmlChar *content; /* content or ndata if unparsed */
|
|
int length; /* the content length */
|
|
xmlEntityType etype; /* The entity type */
|
|
const xmlChar *ExternalID; /* External identifier for PUBLIC */
|
|
const xmlChar *SystemID; /* URI for a SYSTEM or PUBLIC Entity */
|
|
|
|
#ifdef WITH_EXTRA_ENT_DETECT
|
|
/* Referenced entities name stack */
|
|
xmlChar *ent; /* Current parsed Node */
|
|
int entNr; /* Depth of the parsing stack */
|
|
int entMax; /* Max depth of the parsing stack */
|
|
xmlChar * *entTab; /* array of nodes */
|
|
#endif
|
|
};</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6228"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLENTITYPTR"
|
|
></A
|
|
>xmlEntityPtr</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>typedef xmlEntity *xmlEntityPtr;</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6233"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XML-MIN-ENTITIES-TABLE"
|
|
></A
|
|
>XML_MIN_ENTITIES_TABLE</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>#define XML_MIN_ENTITIES_TABLE 32</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6238"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLENTITIESTABLE"
|
|
></A
|
|
>struct xmlEntitiesTable</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>struct xmlEntitiesTable {
|
|
int nb_entities; /* number of elements stored */
|
|
int max_entities; /* maximum number of elements */
|
|
xmlEntityPtr *table; /* the table of entities */
|
|
};</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6243"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLENTITIESTABLEPTR"
|
|
></A
|
|
>xmlEntitiesTablePtr</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>typedef xmlEntitiesTable *xmlEntitiesTablePtr;</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6248"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLADDDOCENTITY"
|
|
></A
|
|
>xmlAddDocEntity ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> xmlAddDocEntity (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name,
|
|
int type,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *ExternalID,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *SystemID,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *content);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Register a new entity for this document.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>doc</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the document</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>name</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity name</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>type</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity type XML_xxx_yyy_ENTITY</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>ExternalID</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity external ID if available</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>SystemID</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity system ID if available</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>content</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity content</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>a pointer to the entity or NULL in case of error</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6293"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLADDDTDENTITY"
|
|
></A
|
|
>xmlAddDtdEntity ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> xmlAddDtdEntity (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name,
|
|
int type,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *ExternalID,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *SystemID,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *content);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Register a new entity for this document DTD external subset.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>doc</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the document</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>name</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity name</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>type</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity type XML_xxx_yyy_ENTITY</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>ExternalID</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity external ID if available</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>SystemID</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity system ID if available</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>content</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity content</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>a pointer to the entity or NULL in case of error</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6338"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLGETPREDEFINEDENTITY"
|
|
></A
|
|
>xmlGetPredefinedEntity ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> xmlGetPredefinedEntity (const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Check whether this name is an predefined entity.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>name</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity name</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>NULL if not, othervise the entity</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6359"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLGETDOCENTITY"
|
|
></A
|
|
>xmlGetDocEntity ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> xmlGetDocEntity (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Do an entity lookup in the document entity hash table and
|
|
returns the corrsponding entity, otherwise a lookup is done
|
|
in the predefined entities too.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>doc</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the document referencing the entity</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>name</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity name</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>A pointer to the entity structure or NULL if not found.</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6385"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLGETDTDENTITY"
|
|
></A
|
|
>xmlGetDtdEntity ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> xmlGetDtdEntity (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Do an entity lookup in the Dtd entity hash table and
|
|
returns the corresponding entity, if found.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>doc</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the document referencing the entity</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>name</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity name</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>A pointer to the entity structure or NULL if not found.</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6411"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLGETPARAMETERENTITY"
|
|
></A
|
|
>xmlGetParameterEntity ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> xmlGetParameterEntity (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *name);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Do an entity lookup in the internal and external subsets and
|
|
returns the corresponding parameter entity, if found.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>doc</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the document referencing the entity</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>name</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity name</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>A pointer to the entity structure or NULL if not found.</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6437"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLENCODEENTITIES"
|
|
></A
|
|
>xmlEncodeEntities ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
>* xmlEncodeEntities (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *input);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Do a global encoding of a string, replacing the predefined entities
|
|
and non ASCII values with their entities and CharRef counterparts.</P
|
|
><P
|
|
>TODO: remove xmlEncodeEntities, once we are not afraid of breaking binary
|
|
compatibility</P
|
|
><P
|
|
>People must migrate their code to xmlEncodeEntitiesReentrant !
|
|
This routine will issue a warning when encountered.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>doc</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the document containing the string</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>input</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> A string to convert to XML.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>A newly allocated string with the substitution done.</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6465"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLENCODEENTITIESREENTRANT"
|
|
></A
|
|
>xmlEncodeEntitiesReentrant ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
>* xmlEncodeEntitiesReentrant (<A
|
|
HREF="gnome-xml-tree.html#XMLDOCPTR"
|
|
>xmlDocPtr</A
|
|
> doc,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *input);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Do a global encoding of a string, replacing the predefined entities
|
|
and non ASCII values with their entities and CharRef counterparts.
|
|
Contrary to xmlEncodeEntities, this routine is reentrant, and result
|
|
must be deallocated.</P
|
|
><P
|
|
>TODO !!!! Once moved to UTF-8 internal encoding, the encoding of non-ascii
|
|
get erroneous.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>doc</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the document containing the string</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>input</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> A string to convert to XML.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>A newly allocated string with the substitution done.</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6492"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLCREATEENTITIESTABLE"
|
|
></A
|
|
>xmlCreateEntitiesTable ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> xmlCreateEntitiesTable (void);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>create and initialize an empty entities hash table.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>the xmlEntitiesTablePtr just created or NULL in case of error.</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6508"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLCOPYENTITIESTABLE"
|
|
></A
|
|
>xmlCopyEntitiesTable ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
><A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> xmlCopyEntitiesTable (<A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> table);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Build a copy of an entity table.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>table</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> An entity table</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
>the new xmlEntitiesTablePtr or NULL in case of error.</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6529"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLFREEENTITIESTABLE"
|
|
></A
|
|
>xmlFreeEntitiesTable ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>void xmlFreeEntitiesTable (<A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> table);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Deallocate the memory used by an entities hash table.</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>table</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> An entity table</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6545"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLDUMPENTITIESTABLE"
|
|
></A
|
|
>xmlDumpEntitiesTable ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>void xmlDumpEntitiesTable (<A
|
|
HREF="gnome-xml-tree.html#XMLBUFFERPTR"
|
|
>xmlBufferPtr</A
|
|
> buf,
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITIESTABLEPTR"
|
|
>xmlEntitiesTablePtr</A
|
|
> table);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>This will dump the content of the entity table as an XML DTD definition</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>buf</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> An XML buffer.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>table</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> An entity table</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6566"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLDUMPENTITYDECL"
|
|
></A
|
|
>xmlDumpEntityDecl ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>void xmlDumpEntityDecl (<A
|
|
HREF="gnome-xml-tree.html#XMLBUFFERPTR"
|
|
>xmlBufferPtr</A
|
|
> buf,
|
|
<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> ent);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>This will dump the content of the entity table as an XML DTD definition</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>buf</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> An XML buffer.</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>ent</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> An entity table</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6587"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLCLEANUPPREDEFINEDENTITIES"
|
|
></A
|
|
>xmlCleanupPredefinedEntities ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>void xmlCleanupPredefinedEntities (void);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Cleanup up the predefined entities table.</P
|
|
><P
|
|
></P
|
|
></DIV
|
|
><HR><DIV
|
|
CLASS="REFSECT2"
|
|
><A
|
|
NAME="AEN6593"
|
|
></A
|
|
><H3
|
|
><A
|
|
NAME="XMLENTITYADDREFERENCE"
|
|
></A
|
|
>xmlEntityAddReference ()</H3
|
|
><TABLE
|
|
BORDER="0"
|
|
BGCOLOR="#D6E8FF"
|
|
WIDTH="100%"
|
|
CELLPADDING="6"
|
|
><TR
|
|
><TD
|
|
><PRE
|
|
CLASS="PROGRAMLISTING"
|
|
>int xmlEntityAddReference (<A
|
|
HREF="gnome-xml-entities.html#XMLENTITYPTR"
|
|
>xmlEntityPtr</A
|
|
> ent,
|
|
const <A
|
|
HREF="gnome-xml-tree.html#XMLCHAR"
|
|
>xmlChar</A
|
|
> *to);</PRE
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
>Function to register reuse of an existing entity from a (new) one
|
|
Used to keep track of references and detect cycles (well formedness
|
|
errors !).</P
|
|
><P
|
|
></P
|
|
><DIV
|
|
CLASS="INFORMALTABLE"
|
|
><P
|
|
></P
|
|
><TABLE
|
|
BORDER="0"
|
|
WIDTH="100%"
|
|
BGCOLOR="#FFD0D0"
|
|
CELLSPACING="0"
|
|
CELLPADDING="4"
|
|
CLASS="CALSTABLE"
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>ent</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> an existing entity</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><TT
|
|
CLASS="PARAMETER"
|
|
><I
|
|
>to</I
|
|
></TT
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> the entity name it's referencing</TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
WIDTH="20%"
|
|
ALIGN="RIGHT"
|
|
VALIGN="TOP"
|
|
><I
|
|
CLASS="EMPHASIS"
|
|
>Returns</I
|
|
> :</TD
|
|
><TD
|
|
WIDTH="80%"
|
|
ALIGN="LEFT"
|
|
VALIGN="TOP"
|
|
> 0 if Okay, -1 in case of general error, 1 in case of loop
|
|
detection.</TD
|
|
></TR
|
|
></TABLE
|
|
><P
|
|
></P
|
|
></DIV
|
|
></DIV
|
|
></DIV
|
|
><DIV
|
|
CLASS="NAVFOOTER"
|
|
><BR
|
|
CLEAR="all"><BR><TABLE
|
|
WIDTH="100%"
|
|
BORDER="0"
|
|
BGCOLOR="#000000"
|
|
CELLPADDING="1"
|
|
CELLSPACING="0"
|
|
><TR
|
|
><TD
|
|
WIDTH="25%"
|
|
BGCOLOR="#C00000"
|
|
ALIGN="left"
|
|
><A
|
|
HREF="gnome-xml-tree.html"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
><<< Previous Page</B
|
|
></FONT
|
|
></A
|
|
></TD
|
|
><TD
|
|
WIDTH="25%"
|
|
BGCOLOR="#0000C0"
|
|
ALIGN="center"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
><A
|
|
HREF="book1.html"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
>Home</B
|
|
></FONT
|
|
></A
|
|
></B
|
|
></FONT
|
|
></TD
|
|
><TD
|
|
WIDTH="25%"
|
|
BGCOLOR="#00C000"
|
|
ALIGN="center"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
><A
|
|
HREF="libxml-lib.html"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
>Up</B
|
|
></FONT
|
|
></A
|
|
></B
|
|
></FONT
|
|
></TD
|
|
><TD
|
|
WIDTH="25%"
|
|
BGCOLOR="#C00000"
|
|
ALIGN="right"
|
|
><A
|
|
HREF="gnome-xml-valid.html"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
>Next Page >>></B
|
|
></FONT
|
|
></A
|
|
></TD
|
|
></TR
|
|
><TR
|
|
><TD
|
|
COLSPAN="2"
|
|
ALIGN="left"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
>tree</B
|
|
></FONT
|
|
></TD
|
|
><TD
|
|
COLSPAN="2"
|
|
ALIGN="right"
|
|
><FONT
|
|
COLOR="#FFFFFF"
|
|
SIZE="3"
|
|
><B
|
|
>valid</B
|
|
></FONT
|
|
></TD
|
|
></TR
|
|
></TABLE
|
|
></DIV
|
|
></BODY
|
|
></HTML
|
|
> |