xmlreader.h revision f8e3db0445a1bc8cfe3f77326b07ec161482caa2
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