entities.h 4.4 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. } xmlEntityType;
  28. /*
  29. * An unit of storage for an entity, contains the string, the value
  30. * and the linkind data needed for the linking in the hash table.
  31. */
  32. struct _xmlEntity {
  33. void *_private; /* application data */
  34. xmlElementType type; /* XML_ENTITY_DECL, must be second ! */
  35. const xmlChar *name; /* Entity name */
  36. struct _xmlNode *children; /* First child link */
  37. struct _xmlNode *last; /* Last child link */
  38. struct _xmlDtd *parent; /* -> DTD */
  39. struct _xmlNode *next; /* next sibling link */
  40. struct _xmlNode *prev; /* previous sibling link */
  41. struct _xmlDoc *doc; /* the containing document */
  42. xmlChar *orig; /* content without ref substitution */
  43. xmlChar *content; /* content or ndata if unparsed */
  44. int length; /* the content length */
  45. xmlEntityType etype; /* The entity type */
  46. const xmlChar *ExternalID; /* External identifier for PUBLIC */
  47. const xmlChar *SystemID; /* URI for a SYSTEM or PUBLIC Entity */
  48. struct _xmlEntity *nexte; /* unused */
  49. const xmlChar *URI; /* the full URI as computed */
  50. int owner; /* does the entity own the childrens */
  51. int flags; /* various flags */
  52. unsigned long expandedSize; /* expanded size */
  53. };
  54. /*
  55. * All entities are stored in an hash table.
  56. * There is 2 separate hash tables for global and parameter entities.
  57. */
  58. typedef struct _xmlHashTable xmlEntitiesTable;
  59. typedef xmlEntitiesTable *xmlEntitiesTablePtr;
  60. /*
  61. * External functions:
  62. */
  63. #ifdef LIBXML_LEGACY_ENABLED
  64. XML_DEPRECATED
  65. XMLPUBFUN void
  66. xmlInitializePredefinedEntities (void);
  67. #endif /* LIBXML_LEGACY_ENABLED */
  68. XMLPUBFUN xmlEntityPtr
  69. xmlNewEntity (xmlDocPtr doc,
  70. const xmlChar *name,
  71. int type,
  72. const xmlChar *ExternalID,
  73. const xmlChar *SystemID,
  74. const xmlChar *content);
  75. XMLPUBFUN xmlEntityPtr
  76. xmlAddDocEntity (xmlDocPtr doc,
  77. const xmlChar *name,
  78. int type,
  79. const xmlChar *ExternalID,
  80. const xmlChar *SystemID,
  81. const xmlChar *content);
  82. XMLPUBFUN xmlEntityPtr
  83. xmlAddDtdEntity (xmlDocPtr doc,
  84. const xmlChar *name,
  85. int type,
  86. const xmlChar *ExternalID,
  87. const xmlChar *SystemID,
  88. const xmlChar *content);
  89. XMLPUBFUN xmlEntityPtr
  90. xmlGetPredefinedEntity (const xmlChar *name);
  91. XMLPUBFUN xmlEntityPtr
  92. xmlGetDocEntity (const xmlDoc *doc,
  93. const xmlChar *name);
  94. XMLPUBFUN xmlEntityPtr
  95. xmlGetDtdEntity (xmlDocPtr doc,
  96. const xmlChar *name);
  97. XMLPUBFUN xmlEntityPtr
  98. xmlGetParameterEntity (xmlDocPtr doc,
  99. const xmlChar *name);
  100. #ifdef LIBXML_LEGACY_ENABLED
  101. XML_DEPRECATED
  102. XMLPUBFUN const xmlChar *
  103. xmlEncodeEntities (xmlDocPtr doc,
  104. const xmlChar *input);
  105. #endif /* LIBXML_LEGACY_ENABLED */
  106. XMLPUBFUN xmlChar *
  107. xmlEncodeEntitiesReentrant(xmlDocPtr doc,
  108. const xmlChar *input);
  109. XMLPUBFUN xmlChar *
  110. xmlEncodeSpecialChars (const xmlDoc *doc,
  111. const xmlChar *input);
  112. XMLPUBFUN xmlEntitiesTablePtr
  113. xmlCreateEntitiesTable (void);
  114. #ifdef LIBXML_TREE_ENABLED
  115. XMLPUBFUN xmlEntitiesTablePtr
  116. xmlCopyEntitiesTable (xmlEntitiesTablePtr table);
  117. #endif /* LIBXML_TREE_ENABLED */
  118. XMLPUBFUN void
  119. xmlFreeEntitiesTable (xmlEntitiesTablePtr table);
  120. #ifdef LIBXML_OUTPUT_ENABLED
  121. XMLPUBFUN void
  122. xmlDumpEntitiesTable (xmlBufferPtr buf,
  123. xmlEntitiesTablePtr table);
  124. XMLPUBFUN void
  125. xmlDumpEntityDecl (xmlBufferPtr buf,
  126. xmlEntityPtr ent);
  127. #endif /* LIBXML_OUTPUT_ENABLED */
  128. #ifdef LIBXML_LEGACY_ENABLED
  129. XMLPUBFUN void
  130. xmlCleanupPredefinedEntities(void);
  131. #endif /* LIBXML_LEGACY_ENABLED */
  132. #ifdef __cplusplus
  133. }
  134. #endif
  135. # endif /* __XML_ENTITIES_H__ */