HTMLparser.h

/*

 * Summary: interface for an HTML 4.0 non-verifying parser

 * Description: this module implements an HTML 4.0 non-verifying parser

 *              with API compatible with the XML parser ones. It should

 *              be able to parse "real world" HTML, even if severely

 *              broken from a specification point of view.

 *

 * Copy: See Copyright for the status of this software.

 *

 * Author: Daniel Veillard

 */



#ifndef __HTML_PARSER_H__

#define __HTML_PARSER_H__

#include <libxml/xmlversion.h>

#include <libxml/parser.h>



#ifdef LIBXML_HTML_ENABLED



#ifdef __cplusplus

extern "C" {

#endif



/*

 * Most of the back-end structures from XML and HTML are shared.

 */

typedef xmlParserCtxt htmlParserCtxt;

typedef xmlParserCtxtPtr htmlParserCtxtPtr;

typedef xmlParserNodeInfo htmlParserNodeInfo;

typedef xmlSAXHandler htmlSAXHandler;

typedef xmlSAXHandlerPtr htmlSAXHandlerPtr;

typedef xmlParserInput htmlParserInput;

typedef xmlParserInputPtr htmlParserInputPtr;

typedef xmlDocPtr htmlDocPtr;

typedef xmlNodePtr htmlNodePtr;



/*

 * Internal description of an HTML element, representing HTML 4.01

 * and XHTML 1.0 (which share the same structure).

 */

typedef struct _htmlElemDesc htmlElemDesc;

typedef htmlElemDesc *htmlElemDescPtr;

struct _htmlElemDesc {

    const char *name;   /* The tag name */

    char startTag;      /* Whether the start tag can be implied */

    char endTag;        /* Whether the end tag can be implied */

    char saveEndTag;    /* Whether the end tag should be saved */

    char empty;         /* Is this an empty element ? */

    char depr;          /* Is this a deprecated element ? */

    char dtd;           /* 1: only in Loose DTD, 2: only Frameset one */

    char isinline;      /* is this a block 0 or inline 1 element */

    const char *desc;   /* the description */



/* NRK Jan.2003

 * New fields encapsulating HTML structure

 *

 * Bugs:

 *      This is a very limited representation.  It fails to tell us when

 *      an element *requires* subelements (we only have whether they're

 *      allowed or not), and it doesn't tell us where CDATA and PCDATA

 *      are allowed.  Some element relationships are not fully represented:

 *      these are flagged with the word MODIFIER

 */

    const char** subelts;               /* allowed sub-elements of this element */

    const char* defaultsubelt;  /* subelement for suggested auto-repair

                                           if necessary or NULL */

    const char** attrs_opt;             /* Optional Attributes */

    const char** attrs_depr;            /* Additional deprecated attributes */

    const char** attrs_req;             /* Required attributes */

};



/*

 * Internal description of an HTML entity.

 */

typedef struct _htmlEntityDesc htmlEntityDesc;

typedef htmlEntityDesc *htmlEntityDescPtr;

struct _htmlEntityDesc {

    unsigned int value; /* the UNICODE value for the character */

    const char *name;   /* The entity name */

    const char *desc;   /* the description */

};



/*

 * There is only few public functions.

 */

XMLPUBFUN const htmlElemDesc * XMLCALL  

                        htmlTagLookup   (const xmlChar *tag);

XMLPUBFUN const htmlEntityDesc * XMLCALL        

                        htmlEntityLookup(const xmlChar *name);

XMLPUBFUN const htmlEntityDesc * XMLCALL        

                        htmlEntityValueLookup(unsigned int value);



XMLPUBFUN int XMLCALL                   

                        htmlIsAutoClosed(htmlDocPtr doc,

                                         htmlNodePtr elem);

XMLPUBFUN int XMLCALL                   

                        htmlAutoCloseTag(htmlDocPtr doc,

                                         const xmlChar *name,

                                         htmlNodePtr elem);

XMLPUBFUN const htmlEntityDesc * XMLCALL        

                        htmlParseEntityRef(htmlParserCtxtPtr ctxt,

                                         const xmlChar **str);

XMLPUBFUN int XMLCALL                   

                        htmlParseCharRef(htmlParserCtxtPtr ctxt);

XMLPUBFUN void XMLCALL                  

                        htmlParseElement(htmlParserCtxtPtr ctxt);



XMLPUBFUN htmlParserCtxtPtr XMLCALL     

                        htmlCreateMemoryParserCtxt(const char *buffer,

                                                   int size);



XMLPUBFUN int XMLCALL                   

                        htmlParseDocument(htmlParserCtxtPtr ctxt);

XMLPUBFUN htmlDocPtr XMLCALL            

                        htmlSAXParseDoc (xmlChar *cur,

                                         const char *encoding,

                                         htmlSAXHandlerPtr sax,

                                         void *userData);

XMLPUBFUN htmlDocPtr XMLCALL            

                        htmlParseDoc    (xmlChar *cur,

                                         const char *encoding);

XMLPUBFUN htmlDocPtr XMLCALL            

                        htmlSAXParseFile(const char *filename,

                                         const char *encoding,

                                         htmlSAXHandlerPtr sax,

                                         void *userData);

XMLPUBFUN htmlDocPtr XMLCALL            

                        htmlParseFile   (const char *filename,

                                         const char *encoding);

XMLPUBFUN int XMLCALL                   

                        UTF8ToHtml      (unsigned char *out,

                                         int *outlen,

                                         const unsigned char *in,

                                         int *inlen);

XMLPUBFUN int XMLCALL                   

                        htmlEncodeEntities(unsigned char *out,

                                         int *outlen,

                                         const unsigned char *in,

                                         int *inlen, int quoteChar);

XMLPUBFUN int XMLCALL                   

                        htmlIsScriptAttribute(const xmlChar *name);

XMLPUBFUN int XMLCALL                   

                        htmlHandleOmittedElem(int val);



#ifdef LIBXML_PUSH_ENABLED

XMLPUBFUN htmlParserCtxtPtr XMLCALL     

                        htmlCreatePushParserCtxt(htmlSAXHandlerPtr sax,

                                                 void *user_data,

                                                 const char *chunk,

                                                 int size,

                                                 const char *filename,

                                                 xmlCharEncoding enc);

XMLPUBFUN int XMLCALL                   

                        htmlParseChunk          (htmlParserCtxtPtr ctxt,

                                                 const char *chunk,

                                                 int size,

                                                 int terminate);

#endif /* LIBXML_PUSH_ENABLED */



XMLPUBFUN void XMLCALL                  

                        htmlFreeParserCtxt      (htmlParserCtxtPtr ctxt);



/*

 * New set of simpler/more flexible APIs

 */

typedef enum {

    HTML_PARSE_NOERROR  = 1<<5, /* suppress error reports */

    HTML_PARSE_NOWARNING= 1<<6, /* suppress warning reports */

    HTML_PARSE_PEDANTIC = 1<<7, /* pedantic error reporting */

    HTML_PARSE_NOBLANKS = 1<<8, /* remove blank nodes */

    HTML_PARSE_NONET    = 1<<11 /* Forbid network access */

} htmlParserOption;



XMLPUBFUN void XMLCALL

                htmlCtxtReset           (htmlParserCtxtPtr ctxt);

XMLPUBFUN int XMLCALL

                htmlCtxtUseOptions      (htmlParserCtxtPtr ctxt,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlReadDoc             (const xmlChar *cur,

                                         const char *URL,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlReadFile            (const char *URL,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlReadMemory          (const char *buffer,

                                         int size,

                                         const char *URL,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlReadFd              (int fd,

                                         const char *URL,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlReadIO              (xmlInputReadCallback ioread,

                                         xmlInputCloseCallback ioclose,

                                         void *ioctx,

                                         const char *URL,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlCtxtReadDoc         (xmlParserCtxtPtr ctxt,

                                         const xmlChar *cur,

                                         const char *URL,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlCtxtReadFile                (xmlParserCtxtPtr ctxt,

                                         const char *filename,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlCtxtReadMemory              (xmlParserCtxtPtr ctxt,

                                         const char *buffer,

                                         int size,

                                         const char *URL,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlCtxtReadFd          (xmlParserCtxtPtr ctxt,

                                         int fd,

                                         const char *URL,

                                         const char *encoding,

                                         int options);

XMLPUBFUN htmlDocPtr XMLCALL

                htmlCtxtReadIO          (xmlParserCtxtPtr ctxt,

                                         xmlInputReadCallback ioread,

                                         xmlInputCloseCallback ioclose,

                                         void *ioctx,

                                         const char *URL,

                                         const char *encoding,

                                         int options);



/* NRK/Jan2003: further knowledge of HTML structure

 */

typedef enum {

  HTML_NA = 0 ,         /* something we don't check at all */

  HTML_INVALID = 0x1 ,

  HTML_DEPRECATED = 0x2 ,

  HTML_VALID = 0x4 ,

  HTML_REQUIRED = 0xc /* VALID bit set so ( & HTML_VALID ) is TRUE */

} htmlStatus ;



/* Using htmlElemDesc rather than name here, to emphasise the fact

   that otherwise there's a lookup overhead

*/

XMLPUBFUN htmlStatus XMLCALL htmlAttrAllowed(const htmlElemDesc*, const xmlChar*, int) ;

XMLPUBFUN int XMLCALL htmlElementAllowedHere(const htmlElemDesc*, const xmlChar*) ;

XMLPUBFUN htmlStatus XMLCALL htmlElementStatusHere(const htmlElemDesc*, const htmlElemDesc*) ;

XMLPUBFUN htmlStatus XMLCALL htmlNodeStatus(const htmlNodePtr, int) ;

#define htmlDefaultSubelement(elt) elt->defaultsubelt

#define htmlElementAllowedHereDesc(parent,elt) \

        htmlElementAllowedHere((parent), (elt)->name)


#define htmlRequiredAttrs(elt) (elt)->attrs_req





#ifdef __cplusplus

}

#endif



#endif /* LIBXML_HTML_ENABLED */

#endif /* __HTML_PARSER_H__ */

---