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
21extern "C" {
22#endif
23
24/*
25 * Most of the back-end structures from XML and HTML are shared.
26 */
27typedef xmlParserCtxt htmlParserCtxt;
28typedef xmlParserCtxtPtr htmlParserCtxtPtr;
29typedef xmlParserNodeInfo htmlParserNodeInfo;
30typedef xmlSAXHandler htmlSAXHandler;
31typedef xmlSAXHandlerPtr htmlSAXHandlerPtr;
32typedef xmlParserInput htmlParserInput;
33typedef xmlParserInputPtr htmlParserInputPtr;
34typedef xmlDocPtr htmlDocPtr;
35typedef 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 */
41typedef struct _htmlElemDesc htmlElemDesc;
42typedef htmlElemDesc *htmlElemDescPtr;
43struct _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 */
75typedef struct _htmlEntityDesc htmlEntityDesc;
76typedef htmlEntityDesc *htmlEntityDescPtr;
77struct _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 */
86XMLPUBFUN const htmlElemDesc * XMLCALL
87			htmlTagLookup	(const xmlChar *tag);
88XMLPUBFUN const htmlEntityDesc * XMLCALL
89			htmlEntityLookup(const xmlChar *name);
90XMLPUBFUN const htmlEntityDesc * XMLCALL
91			htmlEntityValueLookup(unsigned int value);
92
93XMLPUBFUN int XMLCALL
94			htmlIsAutoClosed(htmlDocPtr doc,
95					 htmlNodePtr elem);
96XMLPUBFUN int XMLCALL
97			htmlAutoCloseTag(htmlDocPtr doc,
98					 const xmlChar *name,
99					 htmlNodePtr elem);
100XMLPUBFUN const htmlEntityDesc * XMLCALL
101			htmlParseEntityRef(htmlParserCtxtPtr ctxt,
102					 const xmlChar **str);
103XMLPUBFUN int XMLCALL
104			htmlParseCharRef(htmlParserCtxtPtr ctxt);
105XMLPUBFUN void XMLCALL
106			htmlParseElement(htmlParserCtxtPtr ctxt);
107
108XMLPUBFUN htmlParserCtxtPtr XMLCALL
109			htmlNewParserCtxt(void);
110
111XMLPUBFUN htmlParserCtxtPtr XMLCALL
112			htmlCreateMemoryParserCtxt(const char *buffer,
113						   int size);
114
115XMLPUBFUN int XMLCALL
116			htmlParseDocument(htmlParserCtxtPtr ctxt);
117XMLPUBFUN htmlDocPtr XMLCALL
118			htmlSAXParseDoc	(xmlChar *cur,
119					 const char *encoding,
120					 htmlSAXHandlerPtr sax,
121					 void *userData);
122XMLPUBFUN htmlDocPtr XMLCALL
123			htmlParseDoc	(xmlChar *cur,
124					 const char *encoding);
125XMLPUBFUN htmlDocPtr XMLCALL
126			htmlSAXParseFile(const char *filename,
127					 const char *encoding,
128					 htmlSAXHandlerPtr sax,
129					 void *userData);
130XMLPUBFUN htmlDocPtr XMLCALL
131			htmlParseFile	(const char *filename,
132					 const char *encoding);
133XMLPUBFUN int XMLCALL
134			UTF8ToHtml	(unsigned char *out,
135					 int *outlen,
136					 const unsigned char *in,
137					 int *inlen);
138XMLPUBFUN int XMLCALL
139			htmlEncodeEntities(unsigned char *out,
140					 int *outlen,
141					 const unsigned char *in,
142					 int *inlen, int quoteChar);
143XMLPUBFUN int XMLCALL
144			htmlIsScriptAttribute(const xmlChar *name);
145XMLPUBFUN int XMLCALL
146			htmlHandleOmittedElem(int val);
147
148#ifdef LIBXML_PUSH_ENABLED
149/**
150 * Interfaces for the Push mode.
151 */
152XMLPUBFUN htmlParserCtxtPtr XMLCALL
153			htmlCreatePushParserCtxt(htmlSAXHandlerPtr sax,
154						 void *user_data,
155						 const char *chunk,
156						 int size,
157						 const char *filename,
158						 xmlCharEncoding enc);
159XMLPUBFUN int XMLCALL
160			htmlParseChunk		(htmlParserCtxtPtr ctxt,
161						 const char *chunk,
162						 int size,
163						 int terminate);
164#endif /* LIBXML_PUSH_ENABLED */
165
166XMLPUBFUN 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 */
178typedef 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
189XMLPUBFUN void XMLCALL
190		htmlCtxtReset		(htmlParserCtxtPtr ctxt);
191XMLPUBFUN int XMLCALL
192		htmlCtxtUseOptions	(htmlParserCtxtPtr ctxt,
193					 int options);
194XMLPUBFUN htmlDocPtr XMLCALL
195		htmlReadDoc		(const xmlChar *cur,
196					 const char *URL,
197					 const char *encoding,
198					 int options);
199XMLPUBFUN htmlDocPtr XMLCALL
200		htmlReadFile		(const char *URL,
201					 const char *encoding,
202					 int options);
203XMLPUBFUN htmlDocPtr XMLCALL
204		htmlReadMemory		(const char *buffer,
205					 int size,
206					 const char *URL,
207					 const char *encoding,
208					 int options);
209XMLPUBFUN htmlDocPtr XMLCALL
210		htmlReadFd		(int fd,
211					 const char *URL,
212					 const char *encoding,
213					 int options);
214XMLPUBFUN htmlDocPtr XMLCALL
215		htmlReadIO		(xmlInputReadCallback ioread,
216					 xmlInputCloseCallback ioclose,
217					 void *ioctx,
218					 const char *URL,
219					 const char *encoding,
220					 int options);
221XMLPUBFUN htmlDocPtr XMLCALL
222		htmlCtxtReadDoc		(xmlParserCtxtPtr ctxt,
223					 const xmlChar *cur,
224					 const char *URL,
225					 const char *encoding,
226					 int options);
227XMLPUBFUN htmlDocPtr XMLCALL
228		htmlCtxtReadFile		(xmlParserCtxtPtr ctxt,
229					 const char *filename,
230					 const char *encoding,
231					 int options);
232XMLPUBFUN htmlDocPtr XMLCALL
233		htmlCtxtReadMemory		(xmlParserCtxtPtr ctxt,
234					 const char *buffer,
235					 int size,
236					 const char *URL,
237					 const char *encoding,
238					 int options);
239XMLPUBFUN htmlDocPtr XMLCALL
240		htmlCtxtReadFd		(xmlParserCtxtPtr ctxt,
241					 int fd,
242					 const char *URL,
243					 const char *encoding,
244					 int options);
245XMLPUBFUN 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 */
256typedef 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*/
267XMLPUBFUN htmlStatus XMLCALL htmlAttrAllowed(const htmlElemDesc*, const xmlChar*, int) ;
268XMLPUBFUN int XMLCALL htmlElementAllowedHere(const htmlElemDesc*, const xmlChar*) ;
269XMLPUBFUN htmlStatus XMLCALL htmlElementStatusHere(const htmlElemDesc*, const htmlElemDesc*) ;
270XMLPUBFUN 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__ */
305