entities.h 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151
  1. /*
  2. * Summary: interface for the XML entities handling
  3. * Description: this module provides some of the entity API needed
  4. * for the parser and applications.
  5. *
  6. * Copy: See Copyright for the status of this software.
  7. *
  8. * Author: Daniel Veillard
  9. */
  10. #ifndef __XML_ENTITIES_H__
  11. #define __XML_ENTITIES_H__
  12. #include <libxml/xmlversion.h>
  13. #include <libxml/tree.h>
  14. #ifdef __cplusplus
  15. extern "C" {
  16. #endif
  17. /*
  18. * The different valid entity types.
  19. */
  20. typedef enum {
  21. XML_INTERNAL_GENERAL_ENTITY = 1,
  22. XML_EXTERNAL_GENERAL_PARSED_ENTITY = 2,
  23. XML_EXTERNAL_GENERAL_UNPARSED_ENTITY = 3,
  24. XML_INTERNAL_PARAMETER_ENTITY = 4,
  25. XML_EXTERNAL_PARAMETER_ENTITY = 5,
  26. XML_INTERNAL_PREDEFINED_ENTITY = 6
  27. }
  28. xmlEntityType;
  29. /*
  30. * An unit of storage for an entity, contains the string, the value
  31. * and the linkind data needed for the linking in the hash table.
  32. */
  33. struct _xmlEntity {
  34. void *_private; /* application data */
  35. xmlElementType type; /* XML_ENTITY_DECL, must be second ! */
  36. const xmlChar *name; /* Entity name */
  37. struct _xmlNode *children; /* First child link */
  38. struct _xmlNode *last; /* Last child link */
  39. struct _xmlDtd *parent; /* -> DTD */
  40. struct _xmlNode *next; /* next sibling link */
  41. struct _xmlNode *prev; /* previous sibling link */
  42. struct _xmlDoc *doc; /* the containing document */
  43. xmlChar *orig; /* content without ref substitution */
  44. xmlChar *content; /* content or ndata if unparsed */
  45. int length; /* the content length */
  46. xmlEntityType etype; /* The entity type */
  47. const xmlChar *ExternalID; /* External identifier for PUBLIC */
  48. const xmlChar *SystemID; /* URI for a SYSTEM or PUBLIC Entity */
  49. struct _xmlEntity *nexte; /* unused */
  50. const xmlChar *URI; /* the full URI as computed */
  51. int owner; /* does the entity own the childrens */
  52. int checked; /* was the entity content checked */
  53. /* this is also used to count entites
  54. * references done from that entity */
  55. };
  56. /*
  57. * All entities are stored in an hash table.
  58. * There is 2 separate hash tables for global and parameter entities.
  59. */
  60. typedef struct _xmlHashTable xmlEntitiesTable;
  61. typedef xmlEntitiesTable *xmlEntitiesTablePtr;
  62. /*
  63. * External functions:
  64. */
  65. #ifdef LIBXML_LEGACY_ENABLED
  66. XMLPUBFUN void XMLCALL
  67. xmlInitializePredefinedEntities (void);
  68. #endif /* LIBXML_LEGACY_ENABLED */
  69. XMLPUBFUN xmlEntityPtr XMLCALL
  70. xmlNewEntity (xmlDocPtr doc,
  71. const xmlChar *name,
  72. int type,
  73. const xmlChar *ExternalID,
  74. const xmlChar *SystemID,
  75. const xmlChar *content);
  76. XMLPUBFUN xmlEntityPtr XMLCALL
  77. xmlAddDocEntity (xmlDocPtr doc,
  78. const xmlChar *name,
  79. int type,
  80. const xmlChar *ExternalID,
  81. const xmlChar *SystemID,
  82. const xmlChar *content);
  83. XMLPUBFUN xmlEntityPtr XMLCALL
  84. xmlAddDtdEntity (xmlDocPtr doc,
  85. const xmlChar *name,
  86. int type,
  87. const xmlChar *ExternalID,
  88. const xmlChar *SystemID,
  89. const xmlChar *content);
  90. XMLPUBFUN xmlEntityPtr XMLCALL
  91. xmlGetPredefinedEntity (const xmlChar *name);
  92. XMLPUBFUN xmlEntityPtr XMLCALL
  93. xmlGetDocEntity (xmlDocPtr doc,
  94. const xmlChar *name);
  95. XMLPUBFUN xmlEntityPtr XMLCALL
  96. xmlGetDtdEntity (xmlDocPtr doc,
  97. const xmlChar *name);
  98. XMLPUBFUN xmlEntityPtr XMLCALL
  99. xmlGetParameterEntity (xmlDocPtr doc,
  100. const xmlChar *name);
  101. #ifdef LIBXML_LEGACY_ENABLED
  102. XMLPUBFUN const xmlChar * XMLCALL
  103. xmlEncodeEntities (xmlDocPtr doc,
  104. const xmlChar *input);
  105. #endif /* LIBXML_LEGACY_ENABLED */
  106. XMLPUBFUN xmlChar * XMLCALL
  107. xmlEncodeEntitiesReentrant(xmlDocPtr doc,
  108. const xmlChar *input);
  109. XMLPUBFUN xmlChar * XMLCALL
  110. xmlEncodeSpecialChars (xmlDocPtr doc,
  111. const xmlChar *input);
  112. XMLPUBFUN xmlEntitiesTablePtr XMLCALL
  113. xmlCreateEntitiesTable (void);
  114. #ifdef LIBXML_TREE_ENABLED
  115. XMLPUBFUN xmlEntitiesTablePtr XMLCALL
  116. xmlCopyEntitiesTable (xmlEntitiesTablePtr table);
  117. #endif /* LIBXML_TREE_ENABLED */
  118. XMLPUBFUN void XMLCALL
  119. xmlFreeEntitiesTable (xmlEntitiesTablePtr table);
  120. #ifdef LIBXML_OUTPUT_ENABLED
  121. XMLPUBFUN void XMLCALL
  122. xmlDumpEntitiesTable (xmlBufferPtr buf,
  123. xmlEntitiesTablePtr table);
  124. XMLPUBFUN void XMLCALL
  125. xmlDumpEntityDecl (xmlBufferPtr buf,
  126. xmlEntityPtr ent);
  127. #endif /* LIBXML_OUTPUT_ENABLED */
  128. #ifdef LIBXML_LEGACY_ENABLED
  129. XMLPUBFUN void XMLCALL
  130. xmlCleanupPredefinedEntities(void);
  131. #endif /* LIBXML_LEGACY_ENABLED */
  132. #ifdef __cplusplus
  133. }
  134. #endif
  135. # endif /* __XML_ENTITIES_H__ */