HTMLparser.h@ 64696

最後變更在這個檔案從64696是 58072,由 vboxsync 提交於 9 年前
libxml 2.9.2 unmodified
屬性 svn:eol-style 設為 `native`
檔案大小: 9.2 KB

行
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_NODEFDTD = 1<<2, /* do not default a doctype if not found */
181	HTML_PARSE_NOERROR = 1<<5, /* suppress error reports */
182	HTML_PARSE_NOWARNING= 1<<6, /* suppress warning reports */
183	HTML_PARSE_PEDANTIC = 1<<7, /* pedantic error reporting */
184	HTML_PARSE_NOBLANKS = 1<<8, /* remove blank nodes */
185	HTML_PARSE_NONET = 1<<11,/* Forbid network access */
186	HTML_PARSE_NOIMPLIED= 1<<13,/* Do not add implied html/body... elements */
187	HTML_PARSE_COMPACT = 1<<16,/* compact small text nodes */
188	HTML_PARSE_IGNORE_ENC=1<<21 /* ignore internal document encoding hint */
189	} htmlParserOption;
190
191	XMLPUBFUN void XMLCALL
192	htmlCtxtReset (htmlParserCtxtPtr ctxt);
193	XMLPUBFUN int XMLCALL
194	htmlCtxtUseOptions (htmlParserCtxtPtr ctxt,
195	int options);
196	XMLPUBFUN htmlDocPtr XMLCALL
197	htmlReadDoc (const xmlChar *cur,
198	const char *URL,
199	const char *encoding,
200	int options);
201	XMLPUBFUN htmlDocPtr XMLCALL
202	htmlReadFile (const char *URL,
203	const char *encoding,
204	int options);
205	XMLPUBFUN htmlDocPtr XMLCALL
206	htmlReadMemory (const char *buffer,
207	int size,
208	const char *URL,
209	const char *encoding,
210	int options);
211	XMLPUBFUN htmlDocPtr XMLCALL
212	htmlReadFd (int fd,
213	const char *URL,
214	const char *encoding,
215	int options);
216	XMLPUBFUN htmlDocPtr XMLCALL
217	htmlReadIO (xmlInputReadCallback ioread,
218	xmlInputCloseCallback ioclose,
219	void *ioctx,
220	const char *URL,
221	const char *encoding,
222	int options);
223	XMLPUBFUN htmlDocPtr XMLCALL
224	htmlCtxtReadDoc (xmlParserCtxtPtr ctxt,
225	const xmlChar *cur,
226	const char *URL,
227	const char *encoding,
228	int options);
229	XMLPUBFUN htmlDocPtr XMLCALL
230	htmlCtxtReadFile (xmlParserCtxtPtr ctxt,
231	const char *filename,
232	const char *encoding,
233	int options);
234	XMLPUBFUN htmlDocPtr XMLCALL
235	htmlCtxtReadMemory (xmlParserCtxtPtr ctxt,
236	const char *buffer,
237	int size,
238	const char *URL,
239	const char *encoding,
240	int options);
241	XMLPUBFUN htmlDocPtr XMLCALL
242	htmlCtxtReadFd (xmlParserCtxtPtr ctxt,
243	int fd,
244	const char *URL,
245	const char *encoding,
246	int options);
247	XMLPUBFUN htmlDocPtr XMLCALL
248	htmlCtxtReadIO (xmlParserCtxtPtr ctxt,
249	xmlInputReadCallback ioread,
250	xmlInputCloseCallback ioclose,
251	void *ioctx,
252	const char *URL,
253	const char *encoding,
254	int options);
255
256	/* NRK/Jan2003: further knowledge of HTML structure
257	*/
258	typedef enum {
259	HTML_NA = 0 , /* something we don't check at all */
260	HTML_INVALID = 0x1 ,
261	HTML_DEPRECATED = 0x2 ,
262	HTML_VALID = 0x4 ,
263	HTML_REQUIRED = 0xc /* VALID bit set so ( & HTML_VALID ) is TRUE */
264	} htmlStatus ;
265
266	/* Using htmlElemDesc rather than name here, to emphasise the fact
267	that otherwise there's a lookup overhead
268	*/
269	XMLPUBFUN htmlStatus XMLCALL htmlAttrAllowed(const htmlElemDesc, const xmlChar, int) ;
270	XMLPUBFUN int XMLCALL htmlElementAllowedHere(const htmlElemDesc, const xmlChar) ;
271	XMLPUBFUN htmlStatus XMLCALL htmlElementStatusHere(const htmlElemDesc, const htmlElemDesc) ;
272	XMLPUBFUN htmlStatus XMLCALL htmlNodeStatus(const htmlNodePtr, int) ;
273	/**
274	* htmlDefaultSubelement:
275	* @elt: HTML element
276	*
277	* Returns the default subelement for this element
278	*/
279	#define htmlDefaultSubelement(elt) elt->defaultsubelt
280	/**
281	* htmlElementAllowedHereDesc:
282	* @parent: HTML parent element
283	* @elt: HTML element
284	*
285	* Checks whether an HTML element description may be a
286	* direct child of the specified element.
287	*
288	* Returns 1 if allowed; 0 otherwise.
289	*/
290	#define htmlElementAllowedHereDesc(parent,elt) \
291	htmlElementAllowedHere((parent), (elt)->name)
292	/**
293	* htmlRequiredAttrs:
294	* @elt: HTML element
295	*
296	* Returns the attributes required for the specified element.
297	*/
298	#define htmlRequiredAttrs(elt) (elt)->attrs_req
299
300
301	#ifdef __cplusplus
302	}
303	#endif
304
305	#endif /* LIBXML_HTML_ENABLED */
306	#endif /* __HTML_PARSER_H__ */

注意: 瀏覽 TracBrowser 來幫助您使用儲存庫瀏覽器

source: vbox/trunk/src/libs/libxml2-2.9.2/include/libxml/HTMLparser.h@ 64696

以其他格式下載: