2010-11-03 11:01:17 +08:00
|
|
|
/*
|
|
|
|
* Summary: interface for the XML entities handling
|
|
|
|
* Description: this module provides some of the entity API needed
|
|
|
|
* for the parser and applications.
|
|
|
|
*
|
|
|
|
* Copy: See Copyright for the status of this software.
|
|
|
|
*
|
|
|
|
* Author: Daniel Veillard
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __XML_ENTITIES_H__
|
|
|
|
#define __XML_ENTITIES_H__
|
|
|
|
|
|
|
|
#include <libxml/xmlversion.h>
|
|
|
|
#include <libxml/tree.h>
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/*
|
|
|
|
* The different valid entity types.
|
|
|
|
*/
|
|
|
|
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;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* An unit of storage for an entity, contains the string, the value
|
|
|
|
* and the linkind data needed for the linking in the hash table.
|
|
|
|
*/
|
|
|
|
|
|
|
|
struct _xmlEntity {
|
2012-04-19 14:35:52 +08:00
|
|
|
void *_private; /* application data */
|
2010-11-03 11:01:17 +08:00
|
|
|
xmlElementType type; /* XML_ENTITY_DECL, must be second ! */
|
2012-04-19 14:35:52 +08:00
|
|
|
const xmlChar *name; /* Entity name */
|
|
|
|
struct _xmlNode *children; /* First child link */
|
|
|
|
struct _xmlNode *last; /* Last child link */
|
|
|
|
struct _xmlDtd *parent; /* -> DTD */
|
|
|
|
struct _xmlNode *next; /* next sibling link */
|
|
|
|
struct _xmlNode *prev; /* previous sibling link */
|
2010-11-03 11:01:17 +08:00
|
|
|
struct _xmlDoc *doc; /* the containing document */
|
|
|
|
|
2012-04-19 14:35:52 +08:00
|
|
|
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 */
|
|
|
|
|
|
|
|
struct _xmlEntity *nexte; /* unused */
|
|
|
|
const xmlChar *URI; /* the full URI as computed */
|
|
|
|
int owner; /* does the entity own the childrens */
|
|
|
|
int checked; /* was the entity content checked */
|
|
|
|
/* this is also used to count entites
|
|
|
|
* references done from that entity */
|
2010-11-03 11:01:17 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
|
|
* All entities are stored in an hash table.
|
|
|
|
* There is 2 separate hash tables for global and parameter entities.
|
|
|
|
*/
|
|
|
|
|
|
|
|
typedef struct _xmlHashTable xmlEntitiesTable;
|
|
|
|
typedef xmlEntitiesTable *xmlEntitiesTablePtr;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* External functions:
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifdef LIBXML_LEGACY_ENABLED
|
|
|
|
XMLPUBFUN void XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlInitializePredefinedEntities (void);
|
2010-11-03 11:01:17 +08:00
|
|
|
#endif /* LIBXML_LEGACY_ENABLED */
|
|
|
|
|
|
|
|
XMLPUBFUN xmlEntityPtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlNewEntity (xmlDocPtr doc,
|
|
|
|
const xmlChar *name,
|
|
|
|
int type,
|
|
|
|
const xmlChar *ExternalID,
|
|
|
|
const xmlChar *SystemID,
|
|
|
|
const xmlChar *content);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN xmlEntityPtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlAddDocEntity (xmlDocPtr doc,
|
|
|
|
const xmlChar *name,
|
|
|
|
int type,
|
|
|
|
const xmlChar *ExternalID,
|
|
|
|
const xmlChar *SystemID,
|
|
|
|
const xmlChar *content);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN xmlEntityPtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlAddDtdEntity (xmlDocPtr doc,
|
|
|
|
const xmlChar *name,
|
|
|
|
int type,
|
|
|
|
const xmlChar *ExternalID,
|
|
|
|
const xmlChar *SystemID,
|
|
|
|
const xmlChar *content);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN xmlEntityPtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlGetPredefinedEntity (const xmlChar *name);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN xmlEntityPtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlGetDocEntity (xmlDocPtr doc,
|
|
|
|
const xmlChar *name);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN xmlEntityPtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlGetDtdEntity (xmlDocPtr doc,
|
|
|
|
const xmlChar *name);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN xmlEntityPtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlGetParameterEntity (xmlDocPtr doc,
|
|
|
|
const xmlChar *name);
|
2010-11-03 11:01:17 +08:00
|
|
|
#ifdef LIBXML_LEGACY_ENABLED
|
|
|
|
XMLPUBFUN const xmlChar * XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlEncodeEntities (xmlDocPtr doc,
|
|
|
|
const xmlChar *input);
|
2010-11-03 11:01:17 +08:00
|
|
|
#endif /* LIBXML_LEGACY_ENABLED */
|
|
|
|
XMLPUBFUN xmlChar * XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlEncodeEntitiesReentrant(xmlDocPtr doc,
|
|
|
|
const xmlChar *input);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN xmlChar * XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlEncodeSpecialChars (xmlDocPtr doc,
|
|
|
|
const xmlChar *input);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN xmlEntitiesTablePtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlCreateEntitiesTable (void);
|
2010-11-03 11:01:17 +08:00
|
|
|
#ifdef LIBXML_TREE_ENABLED
|
|
|
|
XMLPUBFUN xmlEntitiesTablePtr XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlCopyEntitiesTable (xmlEntitiesTablePtr table);
|
2010-11-03 11:01:17 +08:00
|
|
|
#endif /* LIBXML_TREE_ENABLED */
|
|
|
|
XMLPUBFUN void XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlFreeEntitiesTable (xmlEntitiesTablePtr table);
|
2010-11-03 11:01:17 +08:00
|
|
|
#ifdef LIBXML_OUTPUT_ENABLED
|
|
|
|
XMLPUBFUN void XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlDumpEntitiesTable (xmlBufferPtr buf,
|
|
|
|
xmlEntitiesTablePtr table);
|
2010-11-03 11:01:17 +08:00
|
|
|
XMLPUBFUN void XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlDumpEntityDecl (xmlBufferPtr buf,
|
|
|
|
xmlEntityPtr ent);
|
2010-11-03 11:01:17 +08:00
|
|
|
#endif /* LIBXML_OUTPUT_ENABLED */
|
|
|
|
#ifdef LIBXML_LEGACY_ENABLED
|
|
|
|
XMLPUBFUN void XMLCALL
|
2012-04-19 14:35:52 +08:00
|
|
|
xmlCleanupPredefinedEntities(void);
|
2010-11-03 11:01:17 +08:00
|
|
|
#endif /* LIBXML_LEGACY_ENABLED */
|
|
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
# endif /* __XML_ENTITIES_H__ */
|