src/third_party/libxml/src/include/libxml/HTMLparser.h

   1 /*
   2  * Summary: interface for an HTML 4.0 non-verifying parser
   3  * Description: this module implements an HTML 4.0 non-verifying parser
   4  *              with API compatible with the XML parser ones. It should
   5  *              be able to parse "real world" HTML, even if severely
   6  *              broken from a specification point of view.
   7  *
   8  * Copy: See Copyright for the status of this software.
   9  *
  10  * Author: Daniel Veillard
  11  */
  12
  13 #ifndef __HTML_PARSER_H__
  14 #define __HTML_PARSER_H__
  15 #include <libxml/xmlversion.h>
  16 #include <libxml/parser.h>
  17
  18 #ifdef LIBXML_HTML_ENABLED
  19
  20 #ifdef __cplusplus
  21 extern "C" {
  22 #endif
  23
  24 /*
  25  * Most of the back-end structures from XML and HTML are shared.
  26  */
  27 typedef xmlParserCtxt htmlParserCtxt;
  28 typedef xmlParserCtxtPtr htmlParserCtxtPtr;
  29 typedef xmlParserNodeInfo htmlParserNodeInfo;
  30 typedef xmlSAXHandler htmlSAXHandler;
  31 typedef xmlSAXHandlerPtr htmlSAXHandlerPtr;
  32 typedef xmlParserInput htmlParserInput;
  33 typedef xmlParserInputPtr htmlParserInputPtr;
  34 typedef xmlDocPtr htmlDocPtr;
  35 typedef xmlNodePtr htmlNodePtr;
  36
  37 /*
  38  * Internal description of an HTML element, representing HTML 4.01
  39  * and XHTML 1.0 (which share the same structure).
  40  */
  41 typedef struct _htmlElemDesc htmlElemDesc;
  42 typedef htmlElemDesc *htmlElemDescPtr;
  43 struct _htmlElemDesc {
  44     const char *name;   /* The tag name */
  45     char startTag;      /* Whether the start tag can be implied */
  46     char endTag;        /* Whether the end tag can be implied */
  47     char saveEndTag;    /* Whether the end tag should be saved */
  48     char empty;         /* Is this an empty element ? */
  49     char depr;          /* Is this a deprecated element ? */
  50     char dtd;           /* 1: only in Loose DTD, 2: only Frameset one */
  51     char isinline;      /* is this a block 0 or inline 1 element */
  52     const char *desc;   /* the description */
  53
  54 /* NRK Jan.2003
  55  * New fields encapsulating HTML structure
  56  *
  57  * Bugs:
  58  *      This is a very limited representation.  It fails to tell us when
  59  *      an element *requires* subelements (we only have whether they're
  60  *      allowed or not), and it doesn't tell us where CDATA and PCDATA
  61  *      are allowed.  Some element relationships are not fully represented:
  62  *      these are flagged with the word MODIFIER
  63  */
  64     const char** subelts;               /* allowed sub-elements of this element */
  65     const char* defaultsubelt;  /* subelement for suggested auto-repair
  66                                            if necessary or NULL */
  67     const char** attrs_opt;             /* Optional Attributes */
  68     const char** attrs_depr;            /* Additional deprecated attributes */
  69     const char** attrs_req;             /* Required attributes */
  70 };
  71
  72 /*
  73  * Internal description of an HTML entity.
  74  */
  75 typedef struct _htmlEntityDesc htmlEntityDesc;
  76 typedef htmlEntityDesc *htmlEntityDescPtr;
  77 struct _htmlEntityDesc {
  78     unsigned int value; /* the UNICODE value for the character */
  79     const char *name;   /* The entity name */
  80     const char *desc;   /* the description */
  81 };
  82
  83 /*
  84  * There is only few public functions.
  85  */
  86 XMLPUBFUN const htmlElemDesc * XMLCALL
  87                         htmlTagLookup   (const xmlChar *tag);
  88 XMLPUBFUN const htmlEntityDesc * XMLCALL
  89                         htmlEntityLookup(const xmlChar *name);
  90 XMLPUBFUN const htmlEntityDesc * XMLCALL
  91                         htmlEntityValueLookup(unsigned int value);
  92
  93 XMLPUBFUN int XMLCALL
  94                         htmlIsAutoClosed(htmlDocPtr doc,
  95                                          htmlNodePtr elem);
  96 XMLPUBFUN int XMLCALL
  97                         htmlAutoCloseTag(htmlDocPtr doc,
  98                                          const xmlChar *name,
  99                                          htmlNodePtr elem);
 100 XMLPUBFUN const htmlEntityDesc * XMLCALL
 101                         htmlParseEntityRef(htmlParserCtxtPtr ctxt,
 102                                          const xmlChar **str);
 103 XMLPUBFUN int XMLCALL
 104                         htmlParseCharRef(htmlParserCtxtPtr ctxt);
 105 XMLPUBFUN void XMLCALL
 106                         htmlParseElement(htmlParserCtxtPtr ctxt);
 107
 108 XMLPUBFUN htmlParserCtxtPtr XMLCALL
 109                         htmlNewParserCtxt(void);
 110
 111 XMLPUBFUN htmlParserCtxtPtr XMLCALL
 112                         htmlCreateMemoryParserCtxt(const char *buffer,
 113                                                    int size);
 114
 115 XMLPUBFUN int XMLCALL
 116                         htmlParseDocument(htmlParserCtxtPtr ctxt);
 117 XMLPUBFUN htmlDocPtr XMLCALL
 118                         htmlSAXParseDoc (xmlChar *cur,
 119                                          const char *encoding,
 120                                          htmlSAXHandlerPtr sax,
 121                                          void *userData);
 122 XMLPUBFUN htmlDocPtr XMLCALL
 123                         htmlParseDoc    (xmlChar *cur,
 124                                          const char *encoding);
 125 XMLPUBFUN htmlDocPtr XMLCALL
 126                         htmlSAXParseFile(const char *filename,
 127                                          const char *encoding,
 128                                          htmlSAXHandlerPtr sax,
 129                                          void *userData);
 130 XMLPUBFUN htmlDocPtr XMLCALL
 131                         htmlParseFile   (const char *filename,
 132                                          const char *encoding);
 133 XMLPUBFUN int XMLCALL
 134                         UTF8ToHtml      (unsigned char *out,
 135                                          int *outlen,
 136                                          const unsigned char *in,
 137                                          int *inlen);
 138 XMLPUBFUN int XMLCALL
 139                         htmlEncodeEntities(unsigned char *out,
 140                                          int *outlen,
 141                                          const unsigned char *in,
 142                                          int *inlen, int quoteChar);
 143 XMLPUBFUN int XMLCALL
 144                         htmlIsScriptAttribute(const xmlChar *name);
 145 XMLPUBFUN int XMLCALL
 146                         htmlHandleOmittedElem(int val);
 147
 148 #ifdef LIBXML_PUSH_ENABLED
 149 /**
 150  * Interfaces for the Push mode.
 151  */
 152 XMLPUBFUN htmlParserCtxtPtr XMLCALL
 153                         htmlCreatePushParserCtxt(htmlSAXHandlerPtr sax,
 154                                                  void *user_data,
 155                                                  const char *chunk,
 156                                                  int size,
 157                                                  const char *filename,
 158                                                  xmlCharEncoding enc);
 159 XMLPUBFUN int XMLCALL
 160                         htmlParseChunk          (htmlParserCtxtPtr ctxt,
 161                                                  const char *chunk,
 162                                                  int size,
 163                                                  int terminate);
 164 #endif /* LIBXML_PUSH_ENABLED */
 165
 166 XMLPUBFUN void XMLCALL
 167                         htmlFreeParserCtxt      (htmlParserCtxtPtr ctxt);
 168
 169 /*
 170  * New set of simpler/more flexible APIs
 171  */
 172 /**
 173  * xmlParserOption:
 174  *
 175  * This is the set of XML parser options that can be passed down
 176  * to the xmlReadDoc() and similar calls.
 177  */
 178 typedef enum {
 179     HTML_PARSE_RECOVER  = 1<<0, /* Relaxed parsing */
 180     HTML_PARSE_NOERROR  = 1<<5, /* suppress error reports */
 181     HTML_PARSE_NOWARNING= 1<<6, /* suppress warning reports */
 182     HTML_PARSE_PEDANTIC = 1<<7, /* pedantic error reporting */
 183     HTML_PARSE_NOBLANKS = 1<<8, /* remove blank nodes */
 184     HTML_PARSE_NONET    = 1<<11,/* Forbid network access */
 185     HTML_PARSE_NOIMPLIED= 1<<13,/* Do not add implied html/body... elements */
 186     HTML_PARSE_COMPACT  = 1<<16 /* compact small text nodes */
 187 } htmlParserOption;
 188
 189 XMLPUBFUN void XMLCALL
 190                 htmlCtxtReset           (htmlParserCtxtPtr ctxt);
 191 XMLPUBFUN int XMLCALL
 192                 htmlCtxtUseOptions      (htmlParserCtxtPtr ctxt,
 193                                          int options);
 194 XMLPUBFUN htmlDocPtr XMLCALL
 195                 htmlReadDoc             (const xmlChar *cur,
 196                                          const char *URL,
 197                                          const char *encoding,
 198                                          int options);
 199 XMLPUBFUN htmlDocPtr XMLCALL
 200                 htmlReadFile            (const char *URL,
 201                                          const char *encoding,
 202                                          int options);
 203 XMLPUBFUN htmlDocPtr XMLCALL
 204                 htmlReadMemory          (const char *buffer,
 205                                          int size,
 206                                          const char *URL,
 207                                          const char *encoding,
 208                                          int options);
 209 XMLPUBFUN htmlDocPtr XMLCALL
 210                 htmlReadFd              (int fd,
 211                                          const char *URL,
 212                                          const char *encoding,
 213                                          int options);
 214 XMLPUBFUN htmlDocPtr XMLCALL
 215                 htmlReadIO              (xmlInputReadCallback ioread,
 216                                          xmlInputCloseCallback ioclose,
 217                                          void *ioctx,
 218                                          const char *URL,
 219                                          const char *encoding,
 220                                          int options);
 221 XMLPUBFUN htmlDocPtr XMLCALL
 222                 htmlCtxtReadDoc         (xmlParserCtxtPtr ctxt,
 223                                          const xmlChar *cur,
 224                                          const char *URL,
 225                                          const char *encoding,
 226                                          int options);
 227 XMLPUBFUN htmlDocPtr XMLCALL
 228                 htmlCtxtReadFile                (xmlParserCtxtPtr ctxt,
 229                                          const char *filename,
 230                                          const char *encoding,
 231                                          int options);
 232 XMLPUBFUN htmlDocPtr XMLCALL
 233                 htmlCtxtReadMemory              (xmlParserCtxtPtr ctxt,
 234                                          const char *buffer,
 235                                          int size,
 236                                          const char *URL,
 237                                          const char *encoding,
 238                                          int options);
 239 XMLPUBFUN htmlDocPtr XMLCALL
 240                 htmlCtxtReadFd          (xmlParserCtxtPtr ctxt,
 241                                          int fd,
 242                                          const char *URL,
 243                                          const char *encoding,
 244                                          int options);
 245 XMLPUBFUN htmlDocPtr XMLCALL
 246                 htmlCtxtReadIO          (xmlParserCtxtPtr ctxt,
 247                                          xmlInputReadCallback ioread,
 248                                          xmlInputCloseCallback ioclose,
 249                                          void *ioctx,
 250                                          const char *URL,
 251                                          const char *encoding,
 252                                          int options);
 253
 254 /* NRK/Jan2003: further knowledge of HTML structure
 255  */
 256 typedef enum {
 257   HTML_NA = 0 ,         /* something we don't check at all */
 258   HTML_INVALID = 0x1 ,
 259   HTML_DEPRECATED = 0x2 ,
 260   HTML_VALID = 0x4 ,
 261   HTML_REQUIRED = 0xc /* VALID bit set so ( & HTML_VALID ) is TRUE */
 262 } htmlStatus ;
 263
 264 /* Using htmlElemDesc rather than name here, to emphasise the fact
 265    that otherwise there's a lookup overhead
 266 */
 267 XMLPUBFUN htmlStatus XMLCALL htmlAttrAllowed(const htmlElemDesc*, const xmlChar*, int) ;
 268 XMLPUBFUN int XMLCALL htmlElementAllowedHere(const htmlElemDesc*, const xmlChar*) ;
 269 XMLPUBFUN htmlStatus XMLCALL htmlElementStatusHere(const htmlElemDesc*, const htmlElemDesc*) ;
 270 XMLPUBFUN htmlStatus XMLCALL htmlNodeStatus(const htmlNodePtr, int) ;
 271 /**
 272  * htmlDefaultSubelement:
 273  * @elt: HTML element
 274  *
 275  * Returns the default subelement for this element
 276  */
 277 #define htmlDefaultSubelement(elt) elt->defaultsubelt
 278 /**
 279  * htmlElementAllowedHereDesc:
 280  * @parent: HTML parent element
 281  * @elt: HTML element
 282  *
 283  * Checks whether an HTML element description may be a
 284  * direct child of the specified element.
 285  *
 286  * Returns 1 if allowed; 0 otherwise.
 287  */
 288 #define htmlElementAllowedHereDesc(parent,elt) \
 289         htmlElementAllowedHere((parent), (elt)->name)
 290 /**
 291  * htmlRequiredAttrs:
 292  * @elt: HTML element
 293  *
 294  * Returns the attributes required for the specified element.
 295  */
 296 #define htmlRequiredAttrs(elt) (elt)->attrs_req
 297
 298
 299 #ifdef __cplusplus
 300 }
 301 #endif
 302
 303 #endif /* LIBXML_HTML_ENABLED */
 304 #endif /* __HTML_PARSER_H__ */