1/*
2 * Summary: the XMLReader implementation
3 * Description: API of the XML streaming API based on C# interfaces.
4 *
5 * Copy: See Copyright for the status of this software.
6 *
7 * Author: Daniel Veillard
8 */
9
10#ifndef __XML_XMLREADER_H__
11#define __XML_XMLREADER_H__
12
13#include <libxml/xmlversion.h>
14#include <libxml/tree.h>
15#include <libxml/xmlIO.h>
16#ifdef LIBXML_SCHEMAS_ENABLED
17#include <libxml/relaxng.h>
18#include <libxml/xmlschemas.h>
19#endif
20
21#ifdef __cplusplus
22extern "C" {
23#endif
24
25/**
26 * xmlParserSeverities:
27 *
28 * How severe an error callback is when the per-reader error callback API
29 * is used.
30 */
31typedef enum {
32    XML_PARSER_SEVERITY_VALIDITY_WARNING = 1,
33    XML_PARSER_SEVERITY_VALIDITY_ERROR = 2,
34    XML_PARSER_SEVERITY_WARNING = 3,
35    XML_PARSER_SEVERITY_ERROR = 4
36} xmlParserSeverities;
37
38#ifdef LIBXML_READER_ENABLED
39
40/**
41 * xmlTextReaderMode:
42 *
43 * Internal state values for the reader.
44 */
45typedef enum {
46    XML_TEXTREADER_MODE_INITIAL = 0,
47    XML_TEXTREADER_MODE_INTERACTIVE = 1,
48    XML_TEXTREADER_MODE_ERROR = 2,
49    XML_TEXTREADER_MODE_EOF =3,
50    XML_TEXTREADER_MODE_CLOSED = 4,
51    XML_TEXTREADER_MODE_READING = 5
52} xmlTextReaderMode;
53
54/**
55 * xmlParserProperties:
56 *
57 * Some common options to use with xmlTextReaderSetParserProp, but it
58 * is better to use xmlParserOption and the xmlReaderNewxxx and
59 * xmlReaderForxxx APIs now.
60 */
61typedef enum {
62    XML_PARSER_LOADDTD = 1,
63    XML_PARSER_DEFAULTATTRS = 2,
64    XML_PARSER_VALIDATE = 3,
65    XML_PARSER_SUBST_ENTITIES = 4
66} xmlParserProperties;
67
68/**
69 * xmlReaderTypes:
70 *
71 * Predefined constants for the different types of nodes.
72 */
73typedef enum {
74    XML_READER_TYPE_NONE = 0,
75    XML_READER_TYPE_ELEMENT = 1,
76    XML_READER_TYPE_ATTRIBUTE = 2,
77    XML_READER_TYPE_TEXT = 3,
78    XML_READER_TYPE_CDATA = 4,
79    XML_READER_TYPE_ENTITY_REFERENCE = 5,
80    XML_READER_TYPE_ENTITY = 6,
81    XML_READER_TYPE_PROCESSING_INSTRUCTION = 7,
82    XML_READER_TYPE_COMMENT = 8,
83    XML_READER_TYPE_DOCUMENT = 9,
84    XML_READER_TYPE_DOCUMENT_TYPE = 10,
85    XML_READER_TYPE_DOCUMENT_FRAGMENT = 11,
86    XML_READER_TYPE_NOTATION = 12,
87    XML_READER_TYPE_WHITESPACE = 13,
88    XML_READER_TYPE_SIGNIFICANT_WHITESPACE = 14,
89    XML_READER_TYPE_END_ELEMENT = 15,
90    XML_READER_TYPE_END_ENTITY = 16,
91    XML_READER_TYPE_XML_DECLARATION = 17
92} xmlReaderTypes;
93
94/**
95 * xmlTextReader:
96 *
97 * Structure for an xmlReader context.
98 */
99typedef struct _xmlTextReader xmlTextReader;
100
101/**
102 * xmlTextReaderPtr:
103 *
104 * Pointer to an xmlReader context.
105 */
106typedef xmlTextReader *xmlTextReaderPtr;
107
108/*
109 * Constructors & Destructor
110 */
111XMLPUBFUN xmlTextReaderPtr XMLCALL
112			xmlNewTextReader	(xmlParserInputBufferPtr input,
113	                                         const char *URI);
114XMLPUBFUN xmlTextReaderPtr XMLCALL
115			xmlNewTextReaderFilename(const char *URI);
116
117XMLPUBFUN void XMLCALL
118			xmlFreeTextReader	(xmlTextReaderPtr reader);
119
120XMLPUBFUN int XMLCALL
121            xmlTextReaderSetup(xmlTextReaderPtr reader,
122                   xmlParserInputBufferPtr input, const char *URL,
123                   const char *encoding, int options);
124
125/*
126 * Iterators
127 */
128XMLPUBFUN int XMLCALL
129			xmlTextReaderRead	(xmlTextReaderPtr reader);
130
131#ifdef LIBXML_WRITER_ENABLED
132XMLPUBFUN xmlChar * XMLCALL
133			xmlTextReaderReadInnerXml(xmlTextReaderPtr reader);
134
135XMLPUBFUN xmlChar * XMLCALL
136			xmlTextReaderReadOuterXml(xmlTextReaderPtr reader);
137#endif
138
139XMLPUBFUN xmlChar * XMLCALL
140			xmlTextReaderReadString	(xmlTextReaderPtr reader);
141XMLPUBFUN int XMLCALL
142			xmlTextReaderReadAttributeValue(xmlTextReaderPtr reader);
143
144/*
145 * Attributes of the node
146 */
147XMLPUBFUN int XMLCALL
148			xmlTextReaderAttributeCount(xmlTextReaderPtr reader);
149XMLPUBFUN int XMLCALL
150			xmlTextReaderDepth	(xmlTextReaderPtr reader);
151XMLPUBFUN int XMLCALL
152			xmlTextReaderHasAttributes(xmlTextReaderPtr reader);
153XMLPUBFUN int XMLCALL
154			xmlTextReaderHasValue(xmlTextReaderPtr reader);
155XMLPUBFUN int XMLCALL
156			xmlTextReaderIsDefault	(xmlTextReaderPtr reader);
157XMLPUBFUN int XMLCALL
158			xmlTextReaderIsEmptyElement(xmlTextReaderPtr reader);
159XMLPUBFUN int XMLCALL
160			xmlTextReaderNodeType	(xmlTextReaderPtr reader);
161XMLPUBFUN int XMLCALL
162			xmlTextReaderQuoteChar	(xmlTextReaderPtr reader);
163XMLPUBFUN int XMLCALL
164			xmlTextReaderReadState	(xmlTextReaderPtr reader);
165XMLPUBFUN int XMLCALL
166                        xmlTextReaderIsNamespaceDecl(xmlTextReaderPtr reader);
167
168XMLPUBFUN const xmlChar * XMLCALL
169		    xmlTextReaderConstBaseUri	(xmlTextReaderPtr reader);
170XMLPUBFUN const xmlChar * XMLCALL
171		    xmlTextReaderConstLocalName	(xmlTextReaderPtr reader);
172XMLPUBFUN const xmlChar * XMLCALL
173		    xmlTextReaderConstName	(xmlTextReaderPtr reader);
174XMLPUBFUN const xmlChar * XMLCALL
175		    xmlTextReaderConstNamespaceUri(xmlTextReaderPtr reader);
176XMLPUBFUN const xmlChar * XMLCALL
177		    xmlTextReaderConstPrefix	(xmlTextReaderPtr reader);
178XMLPUBFUN const xmlChar * XMLCALL
179		    xmlTextReaderConstXmlLang	(xmlTextReaderPtr reader);
180XMLPUBFUN const xmlChar * XMLCALL
181		    xmlTextReaderConstString	(xmlTextReaderPtr reader,
182						 const xmlChar *str);
183XMLPUBFUN const xmlChar * XMLCALL
184		    xmlTextReaderConstValue	(xmlTextReaderPtr reader);
185
186/*
187 * use the Const version of the routine for
188 * better performance and simpler code
189 */
190XMLPUBFUN xmlChar * XMLCALL
191			xmlTextReaderBaseUri	(xmlTextReaderPtr reader);
192XMLPUBFUN xmlChar * XMLCALL
193			xmlTextReaderLocalName	(xmlTextReaderPtr reader);
194XMLPUBFUN xmlChar * XMLCALL
195			xmlTextReaderName	(xmlTextReaderPtr reader);
196XMLPUBFUN xmlChar * XMLCALL
197			xmlTextReaderNamespaceUri(xmlTextReaderPtr reader);
198XMLPUBFUN xmlChar * XMLCALL
199			xmlTextReaderPrefix	(xmlTextReaderPtr reader);
200XMLPUBFUN xmlChar * XMLCALL
201			xmlTextReaderXmlLang	(xmlTextReaderPtr reader);
202XMLPUBFUN xmlChar * XMLCALL
203			xmlTextReaderValue	(xmlTextReaderPtr reader);
204
205/*
206 * Methods of the XmlTextReader
207 */
208XMLPUBFUN int XMLCALL
209		    xmlTextReaderClose		(xmlTextReaderPtr reader);
210XMLPUBFUN xmlChar * XMLCALL
211		    xmlTextReaderGetAttributeNo	(xmlTextReaderPtr reader,
212						 int no);
213XMLPUBFUN xmlChar * XMLCALL
214		    xmlTextReaderGetAttribute	(xmlTextReaderPtr reader,
215						 const xmlChar *name);
216XMLPUBFUN xmlChar * XMLCALL
217		    xmlTextReaderGetAttributeNs	(xmlTextReaderPtr reader,
218						 const xmlChar *localName,
219						 const xmlChar *namespaceURI);
220XMLPUBFUN xmlParserInputBufferPtr XMLCALL
221		    xmlTextReaderGetRemainder	(xmlTextReaderPtr reader);
222XMLPUBFUN xmlChar * XMLCALL
223		    xmlTextReaderLookupNamespace(xmlTextReaderPtr reader,
224						 const xmlChar *prefix);
225XMLPUBFUN int XMLCALL
226		    xmlTextReaderMoveToAttributeNo(xmlTextReaderPtr reader,
227						 int no);
228XMLPUBFUN int XMLCALL
229		    xmlTextReaderMoveToAttribute(xmlTextReaderPtr reader,
230						 const xmlChar *name);
231XMLPUBFUN int XMLCALL
232		    xmlTextReaderMoveToAttributeNs(xmlTextReaderPtr reader,
233						 const xmlChar *localName,
234						 const xmlChar *namespaceURI);
235XMLPUBFUN int XMLCALL
236		    xmlTextReaderMoveToFirstAttribute(xmlTextReaderPtr reader);
237XMLPUBFUN int XMLCALL
238		    xmlTextReaderMoveToNextAttribute(xmlTextReaderPtr reader);
239XMLPUBFUN int XMLCALL
240		    xmlTextReaderMoveToElement	(xmlTextReaderPtr reader);
241XMLPUBFUN int XMLCALL
242		    xmlTextReaderNormalization	(xmlTextReaderPtr reader);
243XMLPUBFUN const xmlChar * XMLCALL
244		    xmlTextReaderConstEncoding  (xmlTextReaderPtr reader);
245
246/*
247 * Extensions
248 */
249XMLPUBFUN int XMLCALL
250		    xmlTextReaderSetParserProp	(xmlTextReaderPtr reader,
251						 int prop,
252						 int value);
253XMLPUBFUN int XMLCALL
254		    xmlTextReaderGetParserProp	(xmlTextReaderPtr reader,
255						 int prop);
256XMLPUBFUN xmlNodePtr XMLCALL
257		    xmlTextReaderCurrentNode	(xmlTextReaderPtr reader);
258
259XMLPUBFUN int XMLCALL
260            xmlTextReaderGetParserLineNumber(xmlTextReaderPtr reader);
261
262XMLPUBFUN int XMLCALL
263            xmlTextReaderGetParserColumnNumber(xmlTextReaderPtr reader);
264
265XMLPUBFUN xmlNodePtr XMLCALL
266		    xmlTextReaderPreserve	(xmlTextReaderPtr reader);
267#ifdef LIBXML_PATTERN_ENABLED
268XMLPUBFUN int XMLCALL
269		    xmlTextReaderPreservePattern(xmlTextReaderPtr reader,
270						 const xmlChar *pattern,
271						 const xmlChar **namespaces);
272#endif /* LIBXML_PATTERN_ENABLED */
273XMLPUBFUN xmlDocPtr XMLCALL
274		    xmlTextReaderCurrentDoc	(xmlTextReaderPtr reader);
275XMLPUBFUN xmlNodePtr XMLCALL
276		    xmlTextReaderExpand		(xmlTextReaderPtr reader);
277XMLPUBFUN int XMLCALL
278		    xmlTextReaderNext		(xmlTextReaderPtr reader);
279XMLPUBFUN int XMLCALL
280		    xmlTextReaderNextSibling	(xmlTextReaderPtr reader);
281XMLPUBFUN int XMLCALL
282		    xmlTextReaderIsValid	(xmlTextReaderPtr reader);
283#ifdef LIBXML_SCHEMAS_ENABLED
284XMLPUBFUN int XMLCALL
285		    xmlTextReaderRelaxNGValidate(xmlTextReaderPtr reader,
286						 const char *rng);
287XMLPUBFUN int XMLCALL
288		    xmlTextReaderRelaxNGValidateCtxt(xmlTextReaderPtr reader,
289						 xmlRelaxNGValidCtxtPtr ctxt,
290						 int options);
291
292XMLPUBFUN int XMLCALL
293		    xmlTextReaderRelaxNGSetSchema(xmlTextReaderPtr reader,
294						 xmlRelaxNGPtr schema);
295XMLPUBFUN int XMLCALL
296		    xmlTextReaderSchemaValidate	(xmlTextReaderPtr reader,
297						 const char *xsd);
298XMLPUBFUN int XMLCALL
299		    xmlTextReaderSchemaValidateCtxt(xmlTextReaderPtr reader,
300						 xmlSchemaValidCtxtPtr ctxt,
301						 int options);
302XMLPUBFUN int XMLCALL
303		    xmlTextReaderSetSchema	(xmlTextReaderPtr reader,
304						 xmlSchemaPtr schema);
305#endif
306XMLPUBFUN const xmlChar * XMLCALL
307		    xmlTextReaderConstXmlVersion(xmlTextReaderPtr reader);
308XMLPUBFUN int XMLCALL
309		    xmlTextReaderStandalone     (xmlTextReaderPtr reader);
310
311
312/*
313 * Index lookup
314 */
315XMLPUBFUN long XMLCALL
316		xmlTextReaderByteConsumed	(xmlTextReaderPtr reader);
317
318/*
319 * New more complete APIs for simpler creation and reuse of readers
320 */
321XMLPUBFUN xmlTextReaderPtr XMLCALL
322		xmlReaderWalker		(xmlDocPtr doc);
323XMLPUBFUN xmlTextReaderPtr XMLCALL
324		xmlReaderForDoc		(const xmlChar * cur,
325					 const char *URL,
326					 const char *encoding,
327					 int options);
328XMLPUBFUN xmlTextReaderPtr XMLCALL
329		xmlReaderForFile	(const char *filename,
330					 const char *encoding,
331					 int options);
332XMLPUBFUN xmlTextReaderPtr XMLCALL
333		xmlReaderForMemory	(const char *buffer,
334					 int size,
335					 const char *URL,
336					 const char *encoding,
337					 int options);
338XMLPUBFUN xmlTextReaderPtr XMLCALL
339		xmlReaderForFd		(int fd,
340					 const char *URL,
341					 const char *encoding,
342					 int options);
343XMLPUBFUN xmlTextReaderPtr XMLCALL
344		xmlReaderForIO		(xmlInputReadCallback ioread,
345					 xmlInputCloseCallback ioclose,
346					 void *ioctx,
347					 const char *URL,
348					 const char *encoding,
349					 int options);
350
351XMLPUBFUN int XMLCALL
352		xmlReaderNewWalker	(xmlTextReaderPtr reader,
353					 xmlDocPtr doc);
354XMLPUBFUN int XMLCALL
355		xmlReaderNewDoc		(xmlTextReaderPtr reader,
356					 const xmlChar * cur,
357					 const char *URL,
358					 const char *encoding,
359					 int options);
360XMLPUBFUN int XMLCALL
361		xmlReaderNewFile	(xmlTextReaderPtr reader,
362					 const char *filename,
363					 const char *encoding,
364					 int options);
365XMLPUBFUN int XMLCALL
366		xmlReaderNewMemory	(xmlTextReaderPtr reader,
367					 const char *buffer,
368					 int size,
369					 const char *URL,
370					 const char *encoding,
371					 int options);
372XMLPUBFUN int XMLCALL
373		xmlReaderNewFd		(xmlTextReaderPtr reader,
374					 int fd,
375					 const char *URL,
376					 const char *encoding,
377					 int options);
378XMLPUBFUN int XMLCALL
379		xmlReaderNewIO		(xmlTextReaderPtr reader,
380					 xmlInputReadCallback ioread,
381					 xmlInputCloseCallback ioclose,
382					 void *ioctx,
383					 const char *URL,
384					 const char *encoding,
385					 int options);
386/*
387 * Error handling extensions
388 */
389typedef void *  xmlTextReaderLocatorPtr;
390
391/**
392 * xmlTextReaderErrorFunc:
393 * @arg: the user argument
394 * @msg: the message
395 * @severity: the severity of the error
396 * @locator: a locator indicating where the error occured
397 *
398 * Signature of an error callback from a reader parser
399 */
400typedef void (XMLCALL *xmlTextReaderErrorFunc)(void *arg,
401					       const char *msg,
402					       xmlParserSeverities severity,
403					       xmlTextReaderLocatorPtr locator);
404XMLPUBFUN int XMLCALL
405	    xmlTextReaderLocatorLineNumber(xmlTextReaderLocatorPtr locator);
406XMLPUBFUN xmlChar * XMLCALL
407	    xmlTextReaderLocatorBaseURI (xmlTextReaderLocatorPtr locator);
408XMLPUBFUN void XMLCALL
409	    xmlTextReaderSetErrorHandler(xmlTextReaderPtr reader,
410					 xmlTextReaderErrorFunc f,
411					 void *arg);
412XMLPUBFUN void XMLCALL
413	    xmlTextReaderSetStructuredErrorHandler(xmlTextReaderPtr reader,
414						   xmlStructuredErrorFunc f,
415						   void *arg);
416XMLPUBFUN void XMLCALL
417	    xmlTextReaderGetErrorHandler(xmlTextReaderPtr reader,
418					 xmlTextReaderErrorFunc *f,
419					 void **arg);
420
421#endif /* LIBXML_READER_ENABLED */
422
423#ifdef __cplusplus
424}
425#endif
426
427#endif /* __XML_XMLREADER_H__ */
428
429