Macro used to signal to GCC unused function parameters Macro to cast a string to an xmlChar * when one know its safe. default buffer size 4000 Macro to try to cast the value on the top of the XPath stack to a boolean Macro to try to cast the value on the top of the XPath stack to a number Macro to try to cast the value on the top of the XPath stack to a string Macro to check that the number of args passed to an XPath function matches macro to return from the function if an XPath error was detected macro to return 0 from the function if an XPath error was detected Macro to check that the value on top of the XPath stack is of a given type. Macro to check that the value on top of the XPath stack is of a given type. return(0) in case of failure should be activated only done when debugging libxml. It replaces the allocator with a collect and debug shell to the libc allocator. DEBUG_MEMORY should be activated only when debugging libxml i.e. if libxml has been configured with --with-debug-mem too Whether the memory debugging is configured in Macro, a comment in a HTML document is really implemented the same way as a comment in an XML document. Macro, an entity reference in a HTML document is really implemented the same way as an entity reference in an XML document. Macro, a processing instruction in a HTML document is really implemented the same way as a processing instruction in an XML document. Macro, a preserved node in a HTML document is really implemented the same way as a CDATA section in an XML document. Macro, a text node in a HTML document is really implemented the same way as a text node in an XML document. The parser tries to always have that amount of input ready one of the point is providing context when reporting errors Macro to check the following production in the XML spec Macro to check the following production in the XML spec Macro to check the following production in the XML spec Macro to check the following production in the XML spec Macro to check the following production in the XML spec Macro to check the following production in the XML spec Macro to check the following production in the XML spec Macro to check the following production in the XML spec Macro to check the following production in the XML spec Whether the Canonicalization support is configured in Whether the Catalog support is configured in Whether Debugging module is configured in Used on Windows (MS C compiler only) to declare a variable as imported from the library. This macro should be empty when compiling libxml itself. It should expand to __declspec(dllimport) when the client code includes this header, and that only if the client links dynamically against libxml. For this to work, we need three macros. One tells us which compiler is being used and luckily the compiler defines such a thing: _MSC_VER. The second macro tells us if we are compiling libxml or the client code and we define the macro IN_LIBXML on the compiler's command line for this purpose. The third macro, LIBXML_STATIC, must be defined by any client code which links against libxml statically. Whether the SGML Docbook support is configured in the version string like "1.2.3" Whether the FTP support is configured in Whether the HTML support is configured in Whether the HTTP support is configured in Whether iconv support is available Macro to check that the libxml version in use is compatible with the version the software has been compiled against Whether the thread support is configured in the version number: 1.2.3 value is 1002003 the version number string, 1.2.3 value is "1002003" Whether XInclude is configured in Whether XPath is configured in Whether XPointer is configured in Skips to the next '>' char Skips to the next '<' char Skips the end of line chars Take a block of UTF-8 chars in and try to convert it to an ASCII plus HTML entities block of chars out. Take a block of UTF-8 chars in and try to convert it to an ISO Latin 1 block of chars out. defined if the trio support should not be configured in defined if the trio support need to be configured in The namespace for the XML Catalogs elements the specific XML Catalog Processing Instuction name Bit in the loadsubset context field to tell to do complete the elements attributes lists with the ones defaulted from the DTDs Use it to initialize xmlLoadExtDtdDefaultValue The default version of XML used: 1.0 Bit in the loadsubset context field to tell to do ID/REFs lookups Use it to initialize xmlLoadExtDtdDefaultValue macro to extract the content pointer of a node macro to extract the line number of an element node. This will work only if line numbering is activated by calling xmlLineNumbersDefault(1) before parsing A namespace declaration node Identifiers can be longer, but this will be more costly at runtime. Both general and parameter entities need to be substituted If no entities need to be substituted Whether parameter entities need to be substituted Whether general entities need to be substituted This is the namespace for the special xml: prefix predefined in the XML Namespace specification Macro to raise an XPath error and return Macro to raise an XPath error and return 0 Handle an attribute that has been read by the parser. The default handling is to convert the attribute into an DOM subtree and past it in a new xmlAttr element added to the element. An attribute definition has been parsed An attribute definition has been parsed Handle an attribute that has been read by the parser. The default handling is to convert the attribute into an DOM subtree and past it in a new xmlAttr element added to the element. called when a pcdata block has been parsed called when a pcdata block has been parsed receiving some chars from the parser. receiving some chars from the parser. Check that the current element namespace is the same as the one read upon parsing. A comment has been parsed. A comment has been parsed. Create a parser context for a file content. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. Create a parser context for using the DocBook SGML parser in push mode To allow content encoding detection, size should be >= 4 The value of filename is used for fetching external entities and error/warning reports. Default handler for SGML DocBook, builds the DOM tree Initialize the default SAX handler Take a block of UTF-8 chars in and try to convert it to an ASCII plus SGML entities block of chars out. Free all the memory used by a parser context. However the parsed document in ctxt->myDoc is not freed. Parse a Chunk of memory parse an SGML in-memory document and build a tree. parse an SGML document (and build a tree if using the standard SAX interface). parse a Docbook SGML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. parse an SGML in-memory document and build a tree. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. parse an SGML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. An element definition has been parsed An element definition has been parsed called when the document end has been detected. called when the document end has been detected. called when the end of an element has been detected. called when the end of an element has been detected. An entity definition has been parsed An entity definition has been parsed Display and format an error messages, callback Callback on external subset declaration. Callback on external subset declaration. Display and format fatal error messages, callback A callback for the xmlNanoFTPGet command A callback for the xmlNanoFTPList command Note that only one of year and day:minute are specified Return the column number of the current parsing point. Get an entity by name Get an entity by name Return the line number of the current parsing point. Get the current element namespace. Get a parameter entity by name Get a parameter entity by name Return the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN" Return the system ID, basically URL or filename e.g. http://www.sgmlsource.com/dtds/memo.dtd An old global namespace has been parsed. Does this document has an external subset Does this document has an external subset Does this document has an internal subset Does this document has an internal subset The HTML DTD allows a tag to implicitly close other tags. The list is kept in htmlStartClose array. This function checks if the element or one of it's children would autoclose the given tag. Create a parser context for a file content. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. Create a parser context for using the HTML parser in push mode To allow content encoding detection, size should be >= 4 The value of filename is used for fetching external entities and error/warning reports. Default handler for HTML, builds the DOM tree Initialize the default SAX handler Dump an HTML document. Dump an HTML document. Formating return/spaces are added. Dump an HTML document to an open FILE. Dump an HTML document in memory and return the xmlChar * and it's size. It's up to the caller to free the memory. Take a block of UTF-8 chars in and try to convert it to an ASCII plus HTML entities block of chars out. Lookup the given entity in EntitiesTable Lookup the given entity in EntitiesTable Free all the memory used by a parser context. However the parsed document in ctxt->myDoc is not freed. Encoding definition lookup in the Meta tags Set and return the previous value for handling HTML omitted tags. Initialize the htmlStartCloseIndex for fast lookup of closing tags names. This is not reentrant. Call xmlInitParser() once before processing in case of use in multithreaded programs. The HTML DTD allows a tag to implicitly close other tags. The list is kept in htmlStartClose array. This function checks if a tag is autoclosed by one of it's child Check if an attribute is of content type Script Creates a new HTML document Creates a new HTML document without a DTD node if URI and ExternalID are NULL Dump an HTML node, recursive behaviour,children are printed too, and formatting returns are added. Dump an HTML node, recursive behaviour,children are printed too, and formatting returns are added. Dump an HTML node, recursive behaviour,children are printed too. Dump an HTML node, recursive behaviour,children are printed too. parse Reference declarations Parse a Chunk of memory parse an HTML in-memory document and build a tree. parse an HTML element, this is highly recursive parse an HTML ENTITY references parse an HTML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. Parse an HTML in-memory document. If sax is not NULL, use the SAX callbacks to handle parse events. If sax is NULL, fallback to the default DOM behavior and return a tree. parse an HTML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. Dump an HTML document to a file. If filename is "-" the stdout file is used. Dump an HTML document to a file using a given encoding and formatting returns/spaces are added. Dump an HTML document to a file using a given encoding. Sets the current encoding in the Meta tags NOTE: this will not change the document content encoding, just the META flag associated. Lookup the HTML tag in the ElementTable receiving some ignorable whitespaces from the parser. UNUSED: by default the DOM building will use characters receiving some ignorable whitespaces from the parser. UNUSED: by default the DOM building will use characters Set or reset (if NULL) the default handler for generic errors Initialize the default DocBook SAX handler Initialize the default HTML SAX handler Initialize the default XML SAX handler Pops the top parser input from the input stack Pushes a new parser input on top of the input stack Callback on internal subset declaration. Callback on internal subset declaration. Is this document tagged standalone ? Is this document tagged standalone ? Take a block of ISO Latin 1 chars in and try to convert it to an UTF-8 block of chars out. Pops the top element name from the name stack Pushes a new element name on top of the name stack A namespace has been parsed. Pops the top element node from the node stack Pushes a new element node on top of the node stack What to do when a notation declaration has been parsed. What to do when a notation declaration has been parsed. Global setting, DEPRECATED. A processing instruction has been parsed. A processing instruction has been parsed. called when an entity reference is detected. called when an entity reference is detected. The entity loader, to control the loading of external entities, the application can either: - override this resolveEntity() callback in the SAX block - or better use the xmlSetExternalEntityLoader() function to set up it's own entity resolution routine Callback: The entity loader, to control the loading of external entities, the application can either: - override this resolveEntity() callback in the SAX block - or better use the xmlSetExternalEntityLoader() function to set up it's own entity resolution routine Receive the document locator at startup, actually xmlDefaultSAXLocator Everything is available on the context, so this is useless in our case. Receive the document locator at startup, actually xmlDefaultSAXLocator Everything is available on the context, so this is useless in our case. Set the current element namespace. called when the document start being processed. called when the document start being processed. called when an opening tag has been processed. called when an opening tag has been processed. What to do when an unparsed entity declaration is parsed What to do when an unparsed entity declaration is parsed Pops the top XPath object from the value stack Pushes a new XPath object on top of the value stack Display and format a warning messages, callback Add an entry in the catalog, it may overwrite existing but different entries. Free up all the memory associated with catalogs Remove an entry from the catalog Do a complete resolution lookup of an External Identifier Try to lookup the system ID associated to a public ID in that catalog Try to lookup the catalog resource for a system ID Do a complete resolution lookup of an URI Register a new attribute declaration Note that tree becomes the ownership of the DTD Add a new node to parent, at the end of the child (or property) list merging adjacent TEXT nodes (in which case cur is freed) If the new node was already inserted in a document it is first unlinked from its existing context. If the new node is ATTRIBUTE, it is added into properties instead of children. If there is an attribute with equal name, it is first destroyed. Add a list of node at the end of the child list of the parent merging adjacent TEXT nodes (cur may be freed) Register a new entity for this document. Register a new entity for this document DTD external subset. Register a new element declaration Registers and alias alias for an encoding named name. Existing alias will be overwritten. Register a new id declaration Add a new node elem as the next sibling of cur If the new node was already inserted in a document it is first unlinked from its existing context. As a result of text merging elem may be freed. If the new node is ATTRIBUTE, it is added into properties instead of children. If there is an attribute with equal name, it is first destroyed. Register a new notation declaration Add a new node elem as the previous sibling of cur merging adjacent TEXT nodes (elem may be freed) If the new node was already inserted in a document it is first unlinked from its existing context. If the new node is ATTRIBUTE, it is added into properties instead of children. If there is an attribute with equal name, it is first destroyed. Register a new ref declaration Add a new element elem to the list of siblings of cur merging adjacent TEXT nodes (elem may be freed) If the new element was already inserted in a document it is first unlinked from its existing context. Create a buffered parser output Create a buffered parser input for progressive parsing Add a string range to an XML buffer. if len == -1, the length of str is recomputed. Add a string range to the beginning of an XML buffer. if len == -1, the length of str is recomputed. Global setting, default allocation policy for buffers, default is XML_BUFFER_ALLOC_EXACT Append a zero terminated C string to an XML buffer. Append a zero terminated string to an XML buffer. Function to extract the content of a buffer routine to create an XML buffer. routine to create an XML buffer. Dumps an XML buffer to a FILE *. empty a buffer. Frees an XML buffer. It frees both the content and the structure which encapsulate it. Grow the available space of an XML buffer. Function to get the length of a buffer Resize a buffer to accommodate minimum size of size. Sets the allocation scheme for this buffer Remove the beginning of an XML buffer. routine which manages and grows an output buffer. This one adds xmlChars at the end of the buffer. routine which manage and grows an output buffer. This one add C chars at the end of the array. routine which manage and grows an output buffer. This one writes a quoted or double quoted xmlChar string, checking first if it holds quote or double-quotes internally For VMS only. routine which manages and grows an output buffer. This one adds xmlChars at the end of the buffer. Computes he final URI of the reference done by checking that the given URI is valid, and building the final URI using the base URI. This is processed according to section 5.2 of the RFC 2396 Dumps the canonized image of given XML document into memory. For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or "Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n) Dumps the canonized image of given XML document into the file. For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or "Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n) Dumps the canonized image of given XML document into the provided buffer. For details see "Canonical XML" (http://www.w3.org/TR/xml-c14n) or "Exclusive XML Canonicalization" (http://www.w3.org/TR/xml-exc-c14n) Add an entry in the catalog, it may overwrite existing but different entries. If called before any other catalog routine, allows to override the default shared catalog put in place by xmlInitializeCatalog(); Add the new entry to the catalog list Free up all the memory associated with catalogs Convert all the SGML catalog entries as XML ones Free up all the memory associated with catalogs Free up the memory associated to the catalog list Used to get the user preference w.r.t. to what catalogs should be accepted Try to lookup the system ID associated to a public ID DEPRECATED, use xmlCatalogResolvePublic() Try to lookup the system ID associated to a public ID DEPRECATED, use xmlCatalogResolveSystem() Check is a catalog is empty Do a complete resolution lookup of an External Identifier using a document's private catalog list Do a complete resolution lookup of an URI using a document's private catalog list Remove an entry from the catalog Do a complete resolution lookup of an External Identifier Try to lookup the system ID associated to a public ID Try to lookup the catalog resource for a system ID Do a complete resolution lookup of an URI Used to set the debug level for catalog operation, 0 disable debugging, 1 enable it Allows to set the preference between public and system for deletion in XML Catalog resolution. C.f. section 4.1.1 of the spec Values accepted are XML_CATA_PREFER_PUBLIC or XML_CATA_PREFER_SYSTEM Used to set the user preference w.r.t. to what catalogs should be accepted Generic front-end for encoding handler close function Front-end for the encoding handler input function, but handle only the very first line, i.e. limit itself to 45 chars. Generic front-end for the encoding handler input function Generic front-end for the encoding handler output function a first call with in == NULL has to be made firs to initiate the output in case of non-stateless encoding needing to initiate their state or the output (like the BOM in UTF16). In case of UTF8 sequence conversion errors for the given encoder, the content will be automatically remapped to a CharRef sequence. Take a block of chars in the original encoding and try to convert it to an UTF-8 block of chars out. Take a block of UTF-8 chars in and try to convert it to an other encoding. Note: a first call designed to produce heading info is called with in = NULL. If stateful this should also initialize the encoder state a strdup for char's to xmlChar's a strndup for char's to xmlChar's Checks that the value conforms to the LanguageID production: Checks utf for being valid utf-8. utf is assumed to be null-terminated. This function is not super-strict, as it will allow longer utf-8 sequences than necessary. Note that Java is capable of producing these sequences if provoked. Also note, this routine checks for the 4-byte maximum size, but does not check for 0x10ffff maximum value. check the compiled lib version against the include one. This can warn or immediately kill the application Macro for compatibility naming layer with libxml1 Cleanup the memory allocated for the char encoding support, it unregisters all the encoding handlers and the aliases. Unregisters all aliases clears the entire input callback table. this includes the compiled-in I/O. clears the entire output callback table. this includes the compiled-in I/O callbacks. Cleanup function for the XML parser. It tries to reclaim all parsing related global memory allocated for the parser processing. It doesn't deallocate any document related memory. Calling this function should not prevent reusing the parser. Cleanup up the predefined entities table. xmlCleanupThreads() is used to to cleanup all the thread related data of the libxml2 library once processing has ended. -- Clear (release memory and reinitialize) node info sequence Clear (release owned resources) and reinitialize a parser context Convert all the SGML catalog entries as XML ones Build a copy of an attribute table. append the char value in the array append the char value in the array Do a copy of the document info. If recursive, the content tree will be copied too as well as DTD, namespaces and entities. Do a copy of the dtd. Build a copy of an element content description. Build a copy of an element table. Build a copy of an entity table. Copy an enumeration attribute node (recursive). Do a copy of the namespace. Do a copy of an namespace list. Do a copy of the node. Do a recursive copy of the node list. Build a copy of a notation table. Do a copy of the attribute. Do a copy of an attribute list. Creates a parser context for an XML in-memory document. create and initialize an empty entities hash table. Create a parser context for an external entity Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. create and initialize an enumeration attribute node. Create a parser context for a file content. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. Create a parser context for using the XML parser with an existing I/O stream Create the internal subset of a document Create a parser context for an XML in-memory document. Create a parser context for using the XML parser in push mode To allow content encoding detection, size should be >= 4 The value of filename is used for fetching external entities and error/warning reports. Simply creates an empty xmlURI The current char value, if using UTF-8 this may actually span multiple bytes in the input buffer. Implement the end of line normalization: 2.11 End-of-Line Handling Wherever an external parsed entity or the literal entity value of an internal parsed entity contains either the literal two-character sequence "xDxA" or a standalone literal xD, an XML processor must pass to the application the single character xA. This behavior can conveniently be produced by normalizing all line breaks to xA on input, before parsing.) Dumps debug information for the attribute Dumps debug information for the attribute list Dumps debug information for the DTD Dumps debug information for the document, it's recursive Dumps debug information cncerning the document, not recursive Dumps debug information for all the entities in use by the document Dumps debug information for the element node, it is recursive Dumps debug information for the list of element node, it is recursive Dumps debug information for the element node, it is not recursive Dumps informations about the string, shorten it if necessary This function is deprecated, we now always process entities content through xmlStringDecodeEntities Global setting, default buffer size. Default value is BASE_BUFFER_SIZE Default handler for XML, builds the DOM tree Initialize the default SAX handler The default SAX Locator { getPublicId, getSystemId, getLineNumber, getColumnNumber} Unregisters an encoding alias alias Guess the encoding of the entity using the first bytes of the entity content accordingly of the non-normative appendix F of the XML-1.0 recommendation. Global setting, indicate that the parser should work in validating mode. Disabled by default. Do a copy of the node to a given document. Dump an XML document to an open FILE. Dump an XML document in memory and return the xmlChar * and it's size. It's up to the caller to free the memory. Dump the current DOM tree into memory using the character encoding specified by the caller. Note it is up to the caller of this function to free the allocated memory. Dump an XML document in memory and return the xmlChar * and it's size. It's up to the caller to free the memory. Dump the current DOM tree into memory using the character encoding specified by the caller. Note it is up to the caller of this function to free the allocated memory. Get the root element of the document (doc->children is a list containing possibly comments, PIs, etc ...). Set the root element of the document (doc->children is a list containing possibly comments, PIs, etc ...). This will dump the content of the attribute declaration as an XML DTD definition This will dump the content of the attribute table as an XML DTD definition This will dump the content of the element declaration as an XML DTD definition This will dump the content of the element table as an XML DTD definition This will dump the content of the entity table as an XML DTD definition This will dump the content of the entity table as an XML DTD definition This will dump the content the notation declaration as an XML DTD definition This will dump the content of the notation table as an XML DTD definition Dump an XML/HTML node, recursive behaviour, children are printed too. Do a global encoding of a string, replacing the predefined entities and non ASCII values with their entities and CharRef counterparts. Do a global encoding of a string, replacing the predefined entities and non ASCII values with their entities and CharRef counterparts. Contrary to xmlEncodeEntities, this routine is reentrant, and result must be deallocated. Do a global encoding of a string, replacing the predefined entities this routine is reentrant, and result must be deallocated. Callback function used when one need to be able to track back the provenance of a chunk of nodes inherited from an entity replacement External entity loaders types Search in the registered set the handler able to read/write that encoding. The variable holding the libxml free() implementation Deallocate the memory used by an entities hash table. Free the memory allocated to a Catalog Free up all the structures used by a document, tree included. Free a DTD structure. Free an element content structure. This is a recursive call ! Deallocate the memory used by an element hash table. Deallocate the memory used by an entities hash table. free an enumeration attribute node (recursive). Signature for a free() implementation Deallocate the memory used by an ID hash table. Free up an input stream. xmlFreeMutex() is used to reclaim resources associated with a libxml2 token struct. Free a node, this is a recursive behaviour, all the children are freed too. This doesn't unlink the child from the list, use xmlUnlinkNode() first. Free a node and all its siblings, this is a recursive behaviour, all the children are freed too. Deallocate the memory used by an entities hash table. Free up the structures associated to a namespace Free up all the structures associated to the chained namespaces. Free all the memory used by a parser context. However the parsed document in ctxt->myDoc is not freed. Free up the memory used by a buffered parser input Free one attribute, all the content is freed too Free a property and all its siblings, all the children are freed too. Deallocate the memory used by an Ref hash table. Free up the xmlURI struct Global setting: function used for generic error callbacks Global setting passed to generic error callbacks Signature of the function to use when there is an error and no parsing or validity context available Types are XML_BUFFER_ALLOC_EXACT - use exact sizes, keeps memory usage down XML_BUFFER_ALLOC_DOUBLEIT - double buffer when extra needed, improves performance Search in the registered set the handler able to read/write that encoding. The "canonical" name for XML encoding. C.f. http://www.w3.org/TR/REC-xmlcharencoding Section 4.3.3 Character Encoding in Entities get the default compression mode used, ZLIB based. get the compression ratio for a document, ZLIB based Do an entity lookup in the document entity hash table and returns the corresponding entity, otherwise a lookup is done in the predefined entities too. Search the DTD for the description of this attribute on this element. Search the DTD for the description of this element Do an entity lookup in the DTD entity hash table and returns the corresponding entity, if found. Note: the first argument is the document node, not the DTD node. Search the DTD for the description of this notation Search the DTD for the description of this qualified attribute on this element. Search the DTD for the description of this element Lookup an encoding name for the given alias. Get the default external entity resolver function for the application Read the current value of one feature of this parser instance Copy at most *len feature names into the result array xmlGetGlobalState() is called to retrieve the global state for a thread. Search the attribute declaring the given ID Get the internal subset of a document Search the last child of a node. Get line number of node. this requires activation of this option before invoking the parser by calling xmlLineNumbersDefault(1) Build a structure based Path for the given node Search all the namespace applying to a given element. Search and get the value of an attribute associated to a node This attribute has to be anchored in the namespace specified. This does the entity substitution. This function looks in DTD attribute declaration for FIXED or default declaration values unless DTD use has been turned off. Do an entity lookup in the internal and external subsets and returns the corresponding parameter entity, if found. Check whether this name is an predefined entity. Search and get the value of an attribute associated to a node This does the entity substitution. This function looks in DTD attribute declaration for FIXED or default declaration values unless DTD use has been turned off. Find the set of references for the supplied ID. xmlGetThreadId() find the current thread ID number Global setting, indicate that the parser should provide warnings. Activated by default. Default handling of defined entities, when should we define a new input stream ? When do we just handle that as a set of chars ? Search for an attribute associated to a node This attribute has to be anchored in the namespace specified. This does the entity substitution. This function looks in DTD attribute declaration for FIXED or default declaration values unless DTD use has been turned off. Search an attribute associated to a node This function also looks in DTD attribute declaration for FIXED or default declaration values unless DTD use has been turned off. Add the userdata to the hash table. This can later be retrieved by using the name. Duplicate names generate errors. Add the userdata to the hash table. This can later be retrieved by using the (name, name2) tuple. Duplicate tuples generate errors. Add the userdata to the hash table. This can later be retrieved by using the tuple (name, name2, name3). Duplicate entries generate errors. Callback to copy data from a hash Scan the hash table and applied f to each value. Create a new xmlHashTablePtr. Callback to free data from a hash Free the hash table and its contents. The userdata is deallocated with f if provided. Find the userdata specified by the name. Find the userdata specified by the (name, name2) tuple. Find the userdata specified by the (name, name2, name3) tuple. Find the userdata specified by the name and remove it from the hash table. Existing userdata for this tuple will be removed and freed with f. Find the userdata specified by the (name, name2) tuple and remove it from the hash table. Existing userdata for this tuple will be removed and freed with f. Find the userdata specified by the (name, name2, name3) tuple and remove it from the hash table. Existing userdata for this tuple will be removed and freed with f. Scan the hash table and applied f to each value. Scan the hash table and applied f to each value matching (name, name2, name3) tuple. If one of the names is null, the comparison is considered to match. Scan the hash table and applied f to each value. Scan the hash table and applied f to each value matching (name, name2, name3) tuple. If one of the names is null, the comparison is considered to match. Callback when scanning data in a hash with the simple scanner Callback when scanning data in a hash with the full scanner Query the number of elements installed in the hash table. Add the userdata to the hash table. This can later be retrieved by using the name. Existing entry for this name will be removed and freed with f if found. Add the userdata to the hash table. This can later be retrieved by using the (name, name2) tuple. Existing entry for this tuple will be removed and freed with f if found. Add the userdata to the hash table. This can later be retrieved by using the tuple (name, name2, name3). Existing entry for this tuple will be removed and freed with f if found. Open a temporary buffer to collect the document for a subsequent HTTP POST request. Non-static as is called from the output buffer creation routine. Load and parse a DTD Global setting, asking the serializer to indent the output tree by default Disabled by default Initialize the char encoding support, it registers the default encoding supported. NOTE: while public, this function usually doesn't need to be called in normal processing. Initialize the memory layer. -- Initialize (set to initial state) node info sequence Initialization function for the XML parser. This is not reentrant. Call once before processing in case of use in multithreaded programs. Initialize a parser context xmlInitThreads() is used to to initialize all the thread related data of the libxml2 library. Do the catalog initialization. this function is not thread safe, catalog initialization should preferably be done once at startup xmlInitializeGlobalState() initialize a global state with all the default values of the library. Set up the predefined entities. Callback used in the I/O Input API to close the resource Callback used in the I/O Input API to detect if the current handler can provide input fonctionnalities for this resource. Callback used in the I/O Input API to open the resource Callback used in the I/O Input API to read the resource Check whether the character is allowed by the production [85] BaseChar ::= ... long list see REC ... Check whether the character is allowed by the production [3] S ::= (x20 | x9 | xD | xA)+ Also available as a macro IS_BLANK() Checks whether this node is an empty or whitespace only (and possibly ignorable) text-node. Check whether the character is allowed by the production [2] Char ::= x9 | xA | xD | [x20-xD7FF] | [xE000-xFFFD] | [x10000-x10FFFF] any Unicode character, excluding the surrogate blocks, FFFE, and FFFF. Also available as a macro IS_CHAR() Check whether the character is allowed by the production [87] CombiningChar ::= ... long list see REC ... Check whether the character is allowed by the production [88] Digit ::= ... long list see REC ... Check whether the character is allowed by the production [89] Extender ::= x00B7 | x02D0 | x02D1 | x0387 | x0640 | x0E46 | x0EC6 | x3005 | [x3031-x3035] | [x309D-x309E] | [x30FC-x30FE] Determine whether an attribute is of type ID. In case we have DTD(s) then this is simple, otherwise we use an heuristic: name ID (upper or lowercase). Check whether the character is allowed by the production [86] Ideographic ::= [x4E00-x9FA5] | x3007 | [x3021-x3029] Check whether the character is allowed by the production [84] Letter ::= BaseChar | Ideographic xmlIsMainThread() check whether the current thread is the main thread. Search in the DtDs whether an element accept Mixed content (or ANY) basically if it is supposed to accept text childs Check whether the character is allowed by the production [13] PubidChar ::= x20 | xD | xA | [a-zA-Z0-9] | [-'()+,./:=?;!*#@$_%] Determine whether an attribute is of type Ref. In case we have DTD(s) then this is simple, otherwise we use an heuristic: name Ref (upper or lowercase). Set and return the previous value for default blanks text nodes support. The 1.x version of the parser used an heuristic to try to detect ignorable white spaces. As a result the SAX callback was generating ignorableWhitespace() callbacks instead of characters() one, and when using the DOM output text nodes containing those blanks were not generated. The 2.x and later version will switch to the XML standard way and ignorableWhitespace() are only generated when running the parser in validating mode and when the current element doesn't allow CDATA or mixed content. This function is provided as a way to force the standard behavior on 1.X libs and to switch back to the old mode for compatibility when running 1.X client code on 2.X . Upgrade of 1.X code should be done by using xmlIsBlankNode() commodity function to detect the "empty" nodes generated. This value also affect autogeneration of indentation when saving code if blanks sections are kept, indentation is not generated. Global setting, indicate that the parser should keep all blanks nodes found in the content Activated by default, this is actually needed to have the parser conformant to the XML Recommendation, however the option is kept for some applications since this was libxml1 default behaviour. Set and return the previous value for enabling line numbers in elements contents. This may break on old application and is turned off by default. Global setting, indicate that the parser should store the line number in the content field of elements in the DOM tree. Disabled by default since this may not be safe for old classes of applicaton. See Returns. Insert data in the ordered list at the end for this value Remove the all data in the list Move all the element from the old list in the new list Create a new list Callback function used to compare 2 data Callback function used to free data from a list Deletes the list and its associated data Duplicate the list Is the list empty ? Get the last element in the list Get the first element in the list Insert data in the ordered list at the beginning for this value include all the elements of the second list in the first one and clear the second list Removes the last element in the list Removes the first element in the list add the new data at the end of the list add the new data at the beginning of the list Remove the all instance associated to data in the list Remove the first instance associated to data in the list Remove the last instance associated to data in the list Reverse the order of the elements in the list Search the list in reverse order for an existing value of data Walk all the element of the list in reverse order and apply the walker function to it Search the list for an existing value of data Get the number of elements in the list Sort all the elements in the list Walk all the element of the first from first to last and apply the walker function to it Callback function used when walking a list with xmlListWalk() Load the catalog and build the associated data structures. This can be either an XML Catalog or an SGML Catalog It will recurse in SGML CATALOG entries. On the other hand XML Catalogs are not handled recursively. Load the catalog and makes its definitions effective for the default external entity loader. It will recurse in SGML CATALOG entries. this function is not thread safe, catalog initialization should preferably be done once at startup Load the catalogs and makes their definitions effective for the default external entity loader. this function is not thread safe, catalog initialization should preferably be done once at startup Global setting, indicate that the parser should load DTD while not validating. Disabled by default. Load an external entity, note that the use of this function for unparsed entities may generate problems TODO: a more generic External entity API must be designed Load an SGML super catalog. It won't expand CATALOG or DELEGATE references. This is only needed for manipulating SGML Super Catalogs like adding and removing CATALOG or DELEGATE entries. xmlLockLibrary() is used to take out a re-entrant lock on the libxml2 library. Count the children of node. Dump to output the type and name of node. Wrapper for the malloc() function used in the XML library Signature for a malloc() implementation a malloc() equivalent, with logging of the allocation info. show in-extenso the memory blocks allocated Return the memory access functions set currently in use Override the default memory access functions with a new set This has to be called before any other libxml routines ! show a show display of the memory allocated, and dump the nr last allocated areas which were not freed Wrapper for the strdup() function, xmlStrdup() is usually preferred a strdup() equivalent, with logging of the allocation info. returns the amount of memory currently allocated Dump in-extenso the memory blocks allocated to the file .memorylist xmlMutexLock() is used to lock a libxml2 token. xmlMutexUnlock() is used to unlock a libxml2 token. parse an XML namespace name. parse a namespace prefix declaration TODO: this seems not in use anymore, the namespace handling is done on top of the SAX interfaces, i.e. not on raw input. Check if there is a response from the FTP server after a command. Cleanup the FTP protocol layer. This cleanup proxy informations. Close the connection and both control and transport Close the data connection from the server Tries to open a control connection Tries to open a control connection to the given server/port Tries to change the remote directory Frees the context after closing the connection. Fetch the given file from the server. All data are passed back in the callbacks. The last callback has a size of 0 block. Try to open a data connection to the server. Currently only passive mode is supported. Get the response from the FTP server after a command. Initiate fetch of the given file from the server. Initialize the FTP protocol layer. Currently it just checks for proxy informations, and get the hostname Do a listing on the server. All files info are passed back in the callbacks. Allocate and initialize a new FTP context. Start to fetch the given ftp:// resource Setup the FTP proxy informations. This can also be done by using ftp_proxy ftp_proxy_user and ftp_proxy_password environment variables. Send a QUIT command to the server This function tries to read len bytes from the existing FTP connection and saves them in dest. This is a blocking call. (Re)Initialize the FTP Proxy context by parsing the URL and finding the protocol host port it indicates. Should be like ftp://myproxy/ or ftp://myproxy:3128/ A NULL URL cleans up proxy informations. Update an FTP context by parsing the URL and finding new path it indicates. If there is an error in the protocol, hostname, port or other information, the error is raised. It indicates a new connection has to be established. Get the authentication header of an HTTP context Cleanup the HTTP protocol layer. This function closes an HTTP context, it ends up the connection and free all data related to it. This function try to fetch the indicated resource via HTTP GET and save it's content in the file. Initialize the HTTP protocol layer. Currently it just checks for proxy informations This function try to open a connection to the indicated resource via HTTP using the given method, adding the given extra headers and the input buffer for the request content. This function try to open a connection to the indicated resource via HTTP using the given method, adding the given extra headers and the input buffer for the request content. This function try to open a connection to the indicated resource via HTTP GET. This function try to open a connection to the indicated resource via HTTP GET. This function tries to read len bytes from the existing HTTP connection and saves them in dest. This is a blocking call. Get the latest HTTP return code received This function saves the output of the HTTP transaction to a file It closes and free the context at the end (Re)Initialize the HTTP Proxy context by parsing the URL and finding the protocol host port it indicates. Should be like http://myproxy/ or http://myproxy:3128/ A NULL URL cleans up proxy informations. Creation of a new node containing a CDATA block. create a new Catalog. Creation of a new character reference node. Creation of a new child element, added at the end of parent children list. ns and content parameters are optional (NULL). If content is non NULL, a child list containing the TEXTs and ENTITY_REFs node will be created. NOTE: content is supposed to be a piece of XML CDATA, so it allow entities references, but XML special chars need to be escaped first by using xmlEncodeEntitiesReentrant(). Use xmlNewTextChild() if entities support is not needed. Creation of a new node containing a comment. Creates a new XML document Creation of a new node containing a comment within a document. Creation of a new Fragment node. Creation of a new node element within a document. ns and content are optional (NULL). NOTE: content is supposed to be a piece of XML CDATA, so it allow entities references, but XML special chars need to be escaped first by using xmlEncodeEntitiesReentrant(). Use xmlNewDocRawNode() if you don't need entities support. Create a new property carried by a document. Creation of a new node element within a document. ns and content are optional (NULL). Creation of a new text node within a document. Creation of a new text node with an extra content length parameter. The text node pertain to a given document. Creation of a new DTD for the external subset. To create an internal subset, use xmlCreateIntSubset(). Allocate an element content structure. Create a new input stream based on an xmlEntityPtr Creation of a Namespace, the old way using PI and without scoping DEPRECATED !!! It now create a namespace on the root element of the document if found. Create a new input stream structure encapsulating the input into a stream suitable for the parser. Create a new input stream based on a file. Create a new input stream structure Creation of a new node element. ns is optional (NULL). Creation of a new Namespace. This function will refuse to create a namespace with a similar prefix than an existing one present on this node. We use href==NULL in the case of an element creation where the namespace was not defined. Create a new property tagged with a namespace and carried by a node. Creation of a processing instruction element. Allocate and initialize a new parser context. Create a new property carried by a node. Creation of a new reference node. Create a new input stream based on a memory buffer. Creation of a new text node. Creation of a new child element, added at the end of parent children list. ns and content parameters are optional (NULL). If content is non NULL, a child TEXT node will be created containing the string content. Creation of a new text node with an extra parameter for the content's length Skip to the next char input char. A specific entity loader disabling network accesses, though still allowing local catalog accesses for resolution. Append the extra substring to the node content. Append the extra substring to the node content. Dump an XML node, recursive behaviour,children are printed too. Dump an XML node, recursive behaviour, children are printed too. Searches for the BASE URL. The code should work on both XML and HTML document even if base mechanisms are completely different. It returns the base as defined in RFC 2396 sections 5.1.1. Base URI within Document Content and 5.1.2. Base URI from the Encapsulating Entity However it does not return the document base (5.1.3), use xmlDocumentGetBase() for this Read the value of a node, this can be either the text carried directly by this node if it's a TEXT node or the aggregate string of the values carried by this node child's (TEXT and ENTITY_REF). Entity references are substituted. Searches the language of a node, i.e. the values of the xml:lang attribute or the one carried by the nearest ancestor. Searches the space preserving behaviour of a node, i.e. the values of the xml:space attribute or the one carried by the nearest ancestor. Is this node a Text node ? Returns the string equivalent to the text contained in the Node list made of TEXTs and ENTITY_REFs, contrary to xmlNodeListGetString() this function doesn't do any character encoding handling. Returns the string equivalent to the text contained in the Node list made of TEXTs and ENTITY_REFs Set (or reset) the base URI of a node, i.e. the value of the xml:base attribute. Replace the content of a node. Replace the content of a node. Set the language of a node, i.e. the values of the xml:lang attribute. Set (or reset) the name of a node. Set (or reset) the space preserving behaviour of a node, i.e. the value of the xml:space attribute. Applies the 5 normalization steps to a path string--that is, RFC 2396 Section 5.2, steps 6.c through 6.g. flushes and close the output I/O channel and free up all the associated resources Create a buffered output for the progressive saving to a file descriptor Create a buffered output for the progressive saving to a FILE * buffered C I/O Create a buffered output for the progressive saving of a file If filename is "-' then we use stdout as the output. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. TODO: currently if compression is set, the library only support writing to a local file. Create a buffered output for the progressive saving to an I/O handler flushes the output I/O channel Write the content of the array in the output I/O buffer This routine handle the I18N transcoding from internal UTF-8 The buffer is lossless, i.e. will store in case of partial or delayed writes. Write the content of the string in the output I/O buffer This routine handle the I18N transcoding from internal UTF-8 The buffer is lossless, i.e. will store in case of partial or delayed writes. Callback used in the I/O Output API to close the resource Callback used in the I/O Output API to detect if the current handler can provide output fonctionnalities for this resource. Callback used in the I/O Output API to open the resource Callback used in the I/O Output API to write to the resource parse a value for an attribute Note: the parser won't do substitution of entities here, this will be handled later in xmlStringGetNodeList parse an attribute : parse the Attribute list def for an element parse the Attribute list def for an element Parse a well-balanced chunk of an XML document called by the parser The allowed sequence for the Well Balanced Chunk is the one defined by the content production in the XML grammar: Parse escaped pure raw content. parse an XML file and build a tree. It's like xmlParseFile() except it bypass all catalog lookups. parse a CharData section. if we are within a CDATA section ']]>' marks an end of section. Compare the string to the known encoding schemes already known. Note that the comparison is case insensitive accordingly to the section [XML] 4.3.3 Character Encoding in Entities. parse Reference declarations Parse a Chunk of memory Skip an XML (SGML) comment <!-- .... --> The spec says that "For compatibility, the string "--" (double-hyphen) must not occur within comments. " Parse a content: Parse an external general entity within an existing parsing context An external general parsed entity is well-formed if it matches the production labeled extParsedEnt. Load and parse an external subset. Parse an attribute default declaration parse an XML in-memory document and build a tree. parse a DOCTYPE declaration parse an XML document (and build a tree if using the standard SAX interface). parse an XML element, this is highly recursive VMS version of xmlParseElementChildrenContentDecl() parse the declaration for a Mixed Element content The leading '(' and spaces have been skipped in xmlParseElementContentDecl parse the declaration for an Element content either Mixed or Children, the cases EMPTY and ANY are handled directly in xmlParseElementDecl parse an Element declaration. parse the declaration for a Mixed Element content The leading '(' and spaces have been skipped in xmlParseElementContentDecl parse the XML encoding name parse the XML encoding declaration parse an end of tag parse an XML external entity out of context and build a tree. parse <!ENTITY declarations parse ENTITY references declarations parse a value for ENTITY declarations parse an Enumerated attribute type. parse an Enumeration attribute type. parse a general parsed entity An external general parsed entity is well-formed if it matches the production labeled extParsedEnt. Parse an external general entity An external general parsed entity is well-formed if it matches the production labeled extParsedEnt. Parse an External ID or a Public ID parse Markup declarations from an external subset parse an XML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. parse Markup declarations parse an XML in-memory block and build a tree. parse an XML Misc* optional field. parse an XML name. xmlParseNamespace: parse specific PI '<?namespace ...' constructs. parse an XML Nmtoken. parse a notation declaration parse an Notation attribute type. parse PEReference declarations The entity content is handled directly by pushing it's content as a new input stream. parse an XML Processing Instruction. parse the name of a PI parse an XML public literal Parse and return a string between quotes or doublequotes parse and handle entity references in content, depending on the SAX interface, this may end-up in a call to character() if this is a CharRef, a predefined entity, if there is no reference() callback. or if the parser was asked to switch to that mode. parse the XML standalone declaration parse a start of tag either for rule element or EmptyElement. In both case we don't parse the tag closing chars. parse an XML Literal parse an XML declaration header for external entities Parse an URI Parse an URI reference string and fills in the appropriate fields of the uri structure parse the XML version. parse the XML version value. parse an XML declaration header Insert node info record into the sorted sequence Global setting, asking the parser to print out debugging informations. while handling entities. Disabled by default Display and format an error messages, gives file, line, position and extra parameters. Find the parser node info struct for a given node xmlParserFindNodeInfoIndex : Find the index that the info record for the given node is or should be at in a sorted sequence lookup the directory for that file [69] PEReference ::= '%' Name ';' TODO: Remove, now deprecated ... the test is done directly in the content parsing routines. Create a buffered parser input for the progressive parsing for the input from a file descriptor Create a buffered parser input for the progressive parsing of a FILE * buffered C I/O Create a buffered parser input for the progressive parsing of a file If filename is "-' then we use stdin as the input. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. Do an encoding check if enc == XML_CHAR_ENCODING_NONE VMS version of xmlParserInputBufferCreateFilename() Create a buffered parser input for the progressive parsing for the input from an I/O handler Create a buffered parser input for the progressive parsing for the input from a memory area. Grow up the content of the input buffer, the old data are preserved This routine handle the I18N transcoding to internal UTF-8 This routine is used when operating the parser in normal (pull) mode Push the content of the arry in the input buffer This routine handle the I18N transcoding to internal UTF-8 This is used when operating the parser in progressive (push) mode. Refresh the content of the input buffer, the old data are considered consumed This routine handle the I18N transcoding to internal UTF-8 Callback for freeing some parser input allocations This function increase the input for the parser. It tries to preserve pointers to the input buffer, and keep already read data This function refresh the input for the parser. It doesn't try to preserve pointers to the input buffer, and discard already read data This function removes used input for the parser. Displays current context within the input content for error tracking Displays the associated file and line informations for the current input Display and format an validity error messages, gives file, line, position and extra parameters. Display and format a validity warning messages, gives file, line, position and extra parameters. Constant string describing the internal version of the library Display and format a warning messages, gives file, line, position and extra parameters. Set and return the previous value for enabling pedantic warnings. Global setting, indicate that the parser be pedantic Disabled by default. xmlPopInput: the current input pointed by ctxt->input came to an end pop it and return the next char. Prints the URI in the stream steam. xmlPushInput: switch to a new input stream which is stacked on top of the previous one(s). xmlRMutexLock() is used to lock a libxml2 token_r. xmlRMutexUnlock() is used to unlock a libxml2 token_r. Wrapper for the realloc() function used in the XML library Signature for a realloc() implementation a realloc() equivalent, with logging of the allocation info. This function checks that all the namespaces declared within the given tree are properly declared. This is needed for example after Copy or Cut and then paste operations. The subtree may still hold pointers to namespace declarations outside the subtree or invalid/masked. As much as possible the function try to reuse the existing namespaces found in the new environment. If not possible the new namespaces are redeclared on tree at the top of the given subtree. parse an XML in-memory document and build a tree. In the case the document is not Well Formed, a tree is built anyway parse an XML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. In the case the document is not Well Formed, a tree is built anyway parse an XML in-memory block and build a tree. In the case the document is not Well Formed, a tree is built anyway Register the char encoding handler, surprising, isn't it ? Registers the default compiled-in I/O handlers. Registers the default compiled-in I/O handlers. By default, libxml submits HTTP output requests using the "PUT" method. Calling this method changes the HTTP output method to use the "POST" method instead. Register a new set of I/O callback for handling parser input. Register a new set of I/O callback for handling output. Remove the given attribute from the ID table maintained internally. Unlink and free one attribute, all the content is freed too Note this doesn't work for namespace definition attributes Remove the given attribute from the Ref table maintained internally. Unlink the old node from it's current context, prune the new one at the same place. If cur was already inserted in a document it is first unlinked from its existing context. Macro for compatibility naming layer with libxml1 Load and parse an external subset. parse an XML in-memory document and build a tree. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. parse an XML external entity out of context and build a tree. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. parse an XML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. parse an XML file and build a tree. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time. It use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. parse an XML in-memory block and use the given SAX function block to handle the parsing callback. If sax is NULL, fallback to the default DOM tree building routines. parse an XML file and call the given SAX handler routines. Automatic support for ZLIB/Compress compressed document is provided A better SAX parsing routine. parse an XML in-memory buffer and call the given SAX handler routines. Dump an XML document to a file. Will use compression if compiled in and enabled. If filename is "-" the stdout file is used. Dump an XML document, converting it to the given encoding Dump an XML document to an I/O buffer. Dump an XML document to a file. Will use compression if compiled in and enabled. If filename is "-" the stdout file is used. If format is set then the document will be indented on output. Dump an XML document to an I/O buffer. Global setting, asking the serializer to not output empty tags as <empty/> but <empty></empty>. those two forms are undistinguishable once parsed. Disabled by default Save the URI as an escaped string Trickery: parse an XML name but without consuming the input flow Needed for rollback cases. Used only when parsing entities references. Search a Ns registered under a given name space for a document. recurse on the parents until it finds the defined namespace or return NULL otherwise. nameSpace can be NULL, this is a search for the default namespace. We don't allow to cross entities boundaries. If you don't declare the namespace within those you will be in troubles !!! A warning is generated to cover this case. Search a Ns aliasing a given URI. Recurse on the parents until it finds the defined namespace or return NULL otherwise. Set the buffer allocation method. Types are XML_BUFFER_ALLOC_EXACT - use exact sizes, keeps memory usage down XML_BUFFER_ALLOC_DOUBLEIT - double buffer when extra needed, improves performance set the default compression mode used, ZLIB based Correct values: 0 (uncompressed) to 9 (max compression) set the compression ratio for a document, ZLIB based Correct values: 0 (uncompressed) to 9 (max compression) Set the function to call call back when a xml reference has been made Changes the defaultexternal entity resolver function for the application Change the current value of one feature of this parser instance Function to reset the handler and the error context for out of context error messages. This simply means that handler will be called for subsequent error messages while not parsing nor validating. And ctx will be passed as first argument to handler One can simply force messages to be emitted to another FILE * than stderr by setting ctx to this file handle and handler to NULL. update all nodes in the list to point to the right document Associate a namespace to a node, a posteriori. Set (or reset) an attribute carried by a node. The ns structure must be in scope, this is not checked. Set (or reset) an attribute carried by a node. update all nodes under the tree to point to the right document Setup the parser context to parse a new buffer; Clears any prior contents from the parser context. The buffer parameter must not be NULL, but the filename parameter can be Implements the XML shell This allow to load, validate, view, modify and save a document using a environment similar to a UNIX commandline. Implements the XML shell function "base" dumps the current XML base of the node Implements the XML shell function "cat" dumps the serialization node content (XML or HTML). This is a generic signature for the XML shell functions Implements the XML shell function "dir" dumps informations about the node (namespace, attributes, content). Implements the XML shell function "du" show the structure of the subtree under node tree If tree is null, the command works on the current node. Implements the XML shell function "ls" Does an Unix like listing of the given node (like a directory) Implements the XML shell function "load" loads a new document specified by the filename Print node to stdout Print the xpath error to libxml default error channel Prints result to stdout Implements the XML shell function "pwd" Show the full path from the root to the node, if needed building thumblers when similar elements exists at a given ancestor level. The output is compatible with XPath commands. This is a generic signature for the XML shell input function Implements the XML shell function "save" Write the current document to the filename, or it's original name Implements the XML shell function "validate" Validate the document, if a DTD path is provided, then the validation is done against the given DTD. Implements the XML shell function "write" Write the current node to the filename, it saves the serialization of the subtree under the node specified skip all blanks character found at that point in the input streams. It pops up finished entities in the process if allowable at that point. This will dump the content of the element content definition Intended just for the debug routine parse an UTF8 encoded XML qualified name string parse an XML qualified name string Deprecated, unsafe, use xmlSnprintfElementContent Blocks further parser processing Check if both string are equal of have same content Should be a bit more readable and faster than xmlStrEqual() a strcasecmp for xmlChar's a case-ignoring strstr for xmlChar's a strcat for array of xmlChar's. Since they are supposed to be encoded in UTF-8 or an encoding with 8bit based chars, we assume a termination mark of '0'. a strchr for xmlChar's a strcmp for xmlChar's a strdup for array of xmlChar's. Since they are supposed to be encoded in UTF-8 or an encoding with 8bit based chars, we assume a termination mark of '0'. Signature for an strdup() implementation The current char value, if using UTF-8 this may actually span multiple bytes in the input buffer. Takes a entity string content and process to do the adequate substitutions. Parse the value string and build the node list associated. Should produce a flat tree with only TEXTs and ENTITY_REFs. Parse the value string and build the node list associated. Should produce a flat tree with only TEXTs and ENTITY_REFs. length of a xmlChar's string a strncasecmp for xmlChar's a strncat for array of xmlChar's, it will extend cur with the len first bytes of add. a strncmp for xmlChar's a strndup for array of xmlChar's a strstr for xmlChar's Extract a substring of a given string Set and return the previous value for default entity support. Initially the parser always keep entity references instead of substituting entity values in the output. This function has to be used to change the default parser behavior SAX::substituteEntities() has to be used for changing that on a file by file basis. global variable controlling the entity substitution default behavior change the input functions when discovering the character encoding of a given entity. change the input functions when discovering the character encoding of a given entity. Concat the given string at the end of the existing node content Merge two text nodes into one Escaping routine, does not do validity checks ! It will try to escape the chars needing this, but this is heuristic based it's impossible to be sure. This routine escapes a string to hex, ignoring reserved characters (a-z) and the characters in the exception list. Unescaping routine, does not do validity checks ! Output is direct unsigned char translation of XX values (no encoding) compute the length of an UTF8 string, it doesn't do a full UTF8 checking of the content of the string. a function to provide relative location of a UTF8 char a strndup for array of UTF8's a function to provide the equivalent of fetching a character from a string array storage size of an UTF8 string Note: positions are given in units of UTF-8 chars Unlink a node from it's current context, the node is not freed xmlUnlockLibrary() is used to release a re-entrant lock on the libxml2 library. Remove an attribute carried by a node. Remove an attribute carried by a node. Does the validation related extra step of the normalization of attribute values: Build/extend a list of potential children allowed by the content tree This function returns the list of authorized children to insert within an existing tree while respecting the validity constraints forced by the Dtd. The insertion point is defined using prev and next in the following ways: to insert before 'node': xmlValidGetValidElements(node->prev, node, ... to insert next 'node': xmlValidGetValidElements(node, node->next, ... to replace 'node': xmlValidGetValidElements(node->prev, node->next, ... to prepend a child to 'node': xmlValidGetValidElements(NULL, node->childs, to append a child to 'node': xmlValidGetValidElements(node->last, NULL, ... Does the validation related extra step of the normalization of attribute values: Try to validate a single attribute definition basically it does the following checks as described by the XML-1.0 recommendation: - [ VC: Attribute Default Legal ] - [ VC: Enumeration ] - [ VC: ID Attribute Default ] Validate that the given attribute value match the proper production Try to validate the document instance Does the final step for the document validation once all the incremental validation steps have been completed Try to validate the document against the dtd instance Does the final step for the dtds validation once all the subsets have been parsed Try to validate the subtree under an element Try to validate a single element definition basically it does the following checks as described by the XML-1.0 recommendation: - [ VC: One ID per Element Type ] - [ VC: No Duplicate Types ] - [ VC: Unique Element Type Declaration ] Try to validate a single notation definition basically it does the following checks as described by the XML-1.0 recommendation: - it seems that no validity constraint exists on notation declarations But this function get called anyway ... Validate that the given name match a notation declaration. - [ VC: Notation Declared ] Try to validate a single attribute for an element basically it does the following checks as described by the XML-1.0 recommendation: - [ VC: Attribute Value Type ] - [ VC: Fixed Attribute Default ] - [ VC: Entity Name ] - [ VC: Name Token ] - [ VC: ID ] - [ VC: IDREF ] - [ VC: Entity Name ] - [ VC: Notation Attributes ] Try to validate a single element and it's attributes, basically it does the following checks as described by the XML-1.0 recommendation: - [ VC: Element Valid ] - [ VC: Required Attribute ] Then call xmlValidateOneAttribute() for each attribute present. Try to validate a the root element basically it does the following check as described by the XML-1.0 recommendation: - [ VC: Root Element Type ] it doesn't try to recurse or apply other check to the element Callback called when a validity error is found, this is a message oriented function similar to an *printf function. Callback called when a validity warning is found, this is a message oriented function similar to an *printf function. Implement the XInclude substitution on the XML document doc Implement the add operation on XPath objects: The numeric operators convert their operands to numbers as if by calling the number function. An axis traversal function. To traverse an axis, the engine calls the first time with cur == NULL and repeat until the function returns NULL indicating the end of the axis traversal. Implement the boolean() XPath function boolean boolean(object) he boolean function converts its argument to a boolean as follows: - a number is true if and only if it is neither positive or negative zero nor NaN - a node-set is true if and only if it is non-empty - a string is true if and only if its length is non-zero Converts a boolean to its number value Converts a boolean to its string value. Converts a node-set to its boolean value Converts a node-set to its number value Converts a node-set to its string value. Converts a node to its number value Converts a node to its string value. Converts a number to its boolean value Converts a number to its string value. Converts a string to its boolean value Converts a string to its number value Converts an XPath object to its boolean value Converts an XPath object to its number value Converts an existing object to its string() equivalent Implement the ceiling() XPath function number ceiling(number) The ceiling function returns the smallest (closest to negative infinity) number that is not less than the argument and that is an integer. Check if an XPath error was raised Compare two nodes w.r.t document order Implement the compare operation on XPath objects: arg1 < arg2 (1, 1, ... arg1 <= arg2 (1, 0, ... arg1 > arg2 (0, 1, ... arg1 >= arg2 (0, 0, ... Compile an XPath expression Evaluate the Precompiled XPath expression in the given context. Implement the concat() XPath function string concat(string, string, string*) The concat function returns the concatenation of its arguments. Implement the contains() XPath function boolean contains(string, string) The contains function returns true if the first argument string contains the second argument string, and otherwise returns false. Converts an existing object to its boolean() equivalent A conversion function is associated to a type and used to cast the new type to primitive values. Converts an existing object to its number() equivalent Converts an existing object to its string() equivalent Implement the count() XPath function number count(node-set) Dumps the tree of the compiled XPath expression. Dump the content of the object for debugging purposes Implements the EXSLT - Sets difference() function: node-set set:difference (node-set, node-set) Implements the EXSLT - Sets distinct() function: node-set set:distinct (node-set) nodes is sorted by document order, then exslSetsDistinctSorted is called with the sorted node-set Implements the EXSLT - Sets distinct() function: node-set set:distinct (node-set) Implement the div operation on XPath objects arg1 / arg2: The numeric operators convert their operands to numbers as if by calling the number function. Empties a node-set Implement the equal operation on XPath objects content: arg1 == arg2 Evaluate the XPath Location Path in the given context. Parse and evaluate an XPath expression in the given context, then push the result on the context stack Evaluate the XPath expression in the given context. an XPath evaluation function, the parameters are on the XPath context stack Evaluate a predicate result for the current node. A PredicateExpr is evaluated by evaluating the Expr and converting the result to a boolean. If the result is a number, the result will be converted to true if the number is equal to the position of the context node in the context node list (as returned by the position function) and will be converted to false otherwise; if the result is not a number, then the result will be converted as if by a call to the boolean function. Evaluate a predicate result for the current node. A PredicateExpr is evaluated by evaluating the Expr and converting the result to a boolean. If the result is a number, the result will be converted to true if the number is equal to the position of the context node in the context node list (as returned by the position function) and will be converted to false otherwise; if the result is not a number, then the result will be converted as if by a call to the boolean function. Implement the false() XPath function boolean false() Implement the floor() XPath function number floor(number) The floor function returns the largest (closest to positive infinity) number that is not greater than the argument and that is an integer. Free up the memory allocated by comp Free up an xmlXPathContext Free the NodeSet compound (not the actual nodes !). Free up the xmlXPathObjectPtr obj but don't deallocate the objects in the list contrary to xmlXPathFreeObject(). Free up an xmlXPathObjectPtr object. Free up an xmlXPathParserContext Prototype for callbacks used to plug function lookup in the XPath engine An XPath function The arguments (if any) are popped out from the context stack and the result is pushed on the stack. Search in the Function array of the context for the given function. Search in the Function array of the context for the given function. Get the context node of an XPath context Get the document of an XPath context Get the error code of an XPath context Implements the EXSLT - Sets has-same-nodes function: boolean set:has-same-node(node-set, node-set) Implement the id() XPath function node-set id(object) The id function selects elements by their unique ID (see [5.2.1 Unique IDs]). When the argument to id is of type node-set, then the result is the union of the result of applying id to the string value of each of the nodes in the argument node-set. When the argument to id is of any other type, the argument is converted to a string as if by a call to the string function; the string is split into a whitespace-separated list of tokens (whitespace is any sequence of characters matching the production S); the result is a node-set containing the elements in the same document as the context node that have a unique ID equal to any of the tokens in the list. Initialize the XPath environment Implements the EXSLT - Sets intersection() function: node-set set:intersection (node-set, node-set) Provides a portable isinf() function to detect whether a double is a +Infinite or -Infinite. Based on trio code http://sourceforge.net/projects/ctrio/ Provides a portable isnan() function to detect whether a double is a NotaNumber. Based on trio code http://sourceforge.net/projects/ctrio/ Is the name given a NodeType one. Implement the lang() XPath function boolean lang(string) The lang function returns true or false depending on whether the language of the context node as specified by xml:lang attributes is the same as or is a sublanguage of the language specified by the argument string. The language of the context node is determined by the value of the xml:lang attribute on the context node, or, if the context node has no xml:lang attribute, by the value of the xml:lang attribute on the nearest ancestor of the context node that has an xml:lang attribute. If there is no such attribute, then lang Implement the last() XPath function number last() The last function returns the number of nodes in the context node list. Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set) nodes1 and nodes2 are sorted by document order, then exslSetsLeadingSorted is called. Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set) Implement the local-name() XPath function string local-name(node-set?) The local-name function returns a string containing the local part of the name of the node in the argument node-set that is first in document order. If the node-set is empty or the first node has no name, an empty string is returned. If the argument is omitted it defaults to the context node. Implement the mod operation on XPath objects: arg1 / arg2 The numeric operators convert their operands to numbers as if by calling the number function. Implement the multiply operation on XPath objects: The numeric operators convert their operands to numbers as if by calling the number function. Implement the namespace-uri() XPath function string namespace-uri(node-set?) The namespace-uri function returns a string containing the namespace URI of the expanded name of the node in the argument node-set that is first in document order. If the node-set is empty, the first node has no name, or the expanded name has no namespace URI, an empty string is returned. If the argument is omitted it defaults to the context node. Create a new xmlXPathObjectPtr of type boolean and of value val Create a new xmlXPathObjectPtr of type string and of value val Create a new xmlXPathContext Create a new xmlXPathObjectPtr of type double and of value val Create a new xmlXPathObjectPtr of type NodeSet and initialize it with the single Node val Create a new xmlXPathObjectPtr of type NodeSet and initialize it with the Nodeset val Create a new xmlXPathParserContext Create a new xmlXPathObjectPtr of type string and of value val Create a new xmlXPathObjectPtr of type Value Tree (XSLT) and initialize it with the tree root val Traversal function for the "ancestor" direction the ancestor axis contains the ancestors of the context node; the ancestors of the context node consist of the parent of context node and the parent's parent and so on; the nodes are ordered in reverse document order; thus the parent is the first node on the axis, and the parent's parent is the second node on the axis Traversal function for the "ancestor-or-self" direction he ancestor-or-self axis contains the context node and ancestors of the context node in reverse document order; thus the context node is the first node on the axis, and the context node's parent the second; parent here is defined the same as with the parent axis. Traversal function for the "attribute" direction TODO: support DTD inherited default attributes Traversal function for the "child" direction The child axis contains the children of the context node in document order. Traversal function for the "descendant" direction the descendant axis contains the descendants of the context node in document order; a descendant is a child or a child of a child and so on. Traversal function for the "descendant-or-self" direction the descendant-or-self axis contains the context node and the descendants of the context node in document order; thus the context node is the first node on the axis, and the first child of the context node is the second node on the axis Traversal function for the "following" direction The following axis contains all nodes in the same document as the context node that are after the context node in document order, excluding any descendants and excluding attribute nodes and namespace nodes; the nodes are ordered in document order Traversal function for the "following-sibling" direction The following-sibling axis contains the following siblings of the context node in document order. Traversal function for the "namespace" direction the namespace axis contains the namespace nodes of the context node; the order of nodes on this axis is implementation-defined; the axis will be empty unless the context node is an element Traversal function for the "parent" direction The parent axis contains the parent of the context node, if there is one. Traversal function for the "preceding" direction the preceding axis contains all nodes in the same document as the context node that are before the context node in document order, excluding any ancestors and excluding attribute nodes and namespace nodes; the nodes are ordered in reverse document order Traversal function for the "preceding-sibling" direction The preceding-sibling axis contains the preceding siblings of the context node in reverse document order; the first preceding sibling is first on the axis; the sibling preceding that node is the second on the axis and so on. Traversal function for the "self" direction The self axis contains just the context node itself Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set) nodes is sorted by document order, then exslSetsNodeLeadingSorted is called. Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set) add a new xmlNodePtr to an existing NodeSet add a new xmlNodePtr to an existing NodeSet, optimized version when we are sure the node is not already in the set. checks whether cur contains val Create a new xmlNodeSetPtr of type double and of value val Removes an xmlNodePtr from an existing NodeSet Implement a functionality similar to the DOM NodeList.length Checks whether ns is empty or not Implements a functionality similar to the DOM NodeList.item() Merges two nodesets, all nodes from val2 are added to val1 if val1 is NULL, a new set is created and copied from val2 Removes an entry from an existing NodeSet list. Sort the node set in document order Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set) nodes is sorted by document order, then xmlXPathNodeTrailingSorted is called. Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set) Implement the normalize-space() XPath function string normalize-space(string?) The normalize-space function returns the argument string with white space normalized by stripping leading and trailing whitespace and replacing sequences of whitespace characters by a single space. Whitespace characters are the same allowed by the S production in XML. If the argument is omitted, it defaults to the context node converted to a string, in other words the value of the context node. Implement the not() XPath function boolean not(boolean) The not function returns true if its argument is false, and false otherwise. Search in the namespace declaration array of the context for the given namespace name associated to the given prefix Implement the number() XPath function number number(object?) allocate a new copy of a given object parse an XML namespace non qualified name. parse an XML name Pops a boolean from the stack, handling conversion if needed. Check error with xmlXPathCheckError. Pops an external object from the stack, handling conversion if needed. Check error with xmlXPathCheckError. Pops a node-set from the stack, handling conversion if needed. Check error with xmlXPathCheckError. Pops a number from the stack, handling conversion if needed. Check error with xmlXPathCheckError. Pops a string from the stack, handling conversion if needed. Check error with xmlXPathCheckError. Implement the position() XPath function number position() The position function returns the position of the context node in the context node list. The first position is 1, and so the last position will be equal to last(). Registers all default XPath functions in this context Register a new function. If f is NULL it unregisters the function Registers an external mechanism to do function lookup. Register a new function. If f is NULL it unregisters the function Register a new namespace. If ns_uri is NULL it unregisters the namespace Register a new variable value. If value is NULL it unregisters the variable register an external mechanism to do variable lookup Register a new variable value. If value is NULL it unregisters the variable Cleanup the XPath context data associated to registered functions Cleanup the XPath context data associated to registered variables Cleanup the XPath context data associated to registered variables Pushes the boolean val on the context stack Pushes an empty node-set on the context stack Pushes an empty string on the stack Pushes user data on the context stack Pushes false on the context stack Pushes the node-set ns on the context stack Pushes the double val on the context stack Pushes the string str on the context stack Pushes true on the context stack Initialize the context to the root of the document Implement the round() XPath function number round(number) The round function returns the number that is closest to the argument and that is an integer. If there are two such numbers, then the one that is even is returned. Raises an XPATH_INVALID_ARITY error Raises an error. Raises an XPATH_INVALID_TYPE error Checks if the current value on the XPath stack is an external object. Check if the current value on the XPath stack is a node set or an XSLT value tree Implement the starts-with() XPath function boolean starts-with(string, string) The starts-with function returns true if the first argument string starts with the second argument string, and otherwise returns false. [30a] Float ::= Number ('e' Digits?)? Implement the string() XPath function string string(object?) he string function converts an object to a string as follows: - A node-set is converted to a string by returning the value of the node in the node-set that is first in document order. If the node-set is empty, an empty string is returned. - A number is converted to a string as follows + NaN is converted to the string NaN + positive zero is converted to the string 0 + negative zero is converted to the string 0 + positive infinity is converted to the string Infinity + negative infinity is converted to the string -Infinity + if the number is an integer, the number is represented in decimal form as a Number with no decimal point and no leading zeros, preceded by a minus sign (-) if the number is negative + otherwise, the number is represented in decimal form as a Number including a decimal point with at least one digit before the decimal point and at least one digit after the decimal point, preceded by a minus sign (-) if the number is negative; there must be no leading zeros before the decimal point apart possibly from the one required digit immediately before the decimal point; beyond the one required digit after the decimal point there must be as many, but only as many, more digits as are needed to uniquely distinguish the number from all other IEEE 754 numeric values. - The boolean false value is converted to the string false. The boolean true value is converted to the string true. Implement the string-length() XPath function number string-length(string?) The string-length returns the number of characters in the string (see [3.6 Strings]). If the argument is omitted, it defaults to the context node converted to a string, in other words the value of the context node. Implement the subtraction operation on XPath objects: The numeric operators convert their operands to numbers as if by calling the number function. Implement the substring-after() XPath function string substring-after(string, string) The substring-after function returns the substring of the first argument string that follows the first occurrence of the second argument string in the first argument string, or the empty stringi if the first argument string does not contain the second argument string. For example, substring-after("1999/04/01","/") returns 04/01, and substring-after("1999/04/01","19") returns 99/04/01. Implement the substring-before() XPath function string substring-before(string, string) The substring-before function returns the substring of the first argument string that precedes the first occurrence of the second argument string in the first argument string, or the empty string if the first argument string does not contain the second argument string. For example, substring-before("1999/04/01","/") returns 1999. Implement the substring() XPath function string substring(string, number, number?) The substring function returns the substring of the first argument starting at the position specified in the second argument with length specified in the third argument. For example, substring("12345",2,3) returns "234". If the third argument is not specified, it returns the substring starting at the position specified in the second argument and continuing to the end of the string. For example, substring("12345",2) returns "2345". More precisely, each character in the string (see [3.6 Strings]) is considered to have a numeric position: the position of the first character is 1, the position of the second character is 2 and so on. The returned substring contains those characters for which the position of the character is greater than or equal to the second argument and, if the third argument is specified, less than the sum of the second and third arguments; the comparisons and addition used for the above follow the standard IEEE 754 rules. Thus: - substring("12345", 1.5, 2.6) returns "234" - substring("12345", 0, 3) returns "12" - substring("12345", 0 div 0, 3) returns "" - substring("12345", 1, 0 div 0) returns "" - substring("12345", -42, 1 div 0) returns "12345" - substring("12345", -1 div 0, 1 div 0) returns "" Implement the sum() XPath function number sum(node-set) The sum function returns the sum of the values of the nodes in the argument node-set. Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set) nodes1 and nodes2 are sorted by document order, then xmlXPathTrailingSorted is called. Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set) Implement the translate() XPath function string translate(string, string, string) The translate function returns the first argument string with occurrences of characters in the second argument string replaced by the character at the corresponding position in the third argument string. For example, translate("bar","abc","ABC") returns the string BAr. If there is a character in the second argument string with no character at a corresponding position in the third argument string (because the second argument string is longer than the third argument string), then occurrences of that character in the first argument string are removed. For example, translate("--aaa--","abc-","ABC") Implement the true() XPath function boolean true() Implement the unary - operation on an XPath object The numeric operators convert their operands to numbers as if by calling the number function. Search in the Variable array of the context for the given variable value. Prototype for callbacks used to plug variable lookup in the XPath engine Search in the Variable array of the context for the given variable value. Wraps a string into an XPath object. Wraps the val data into an XPath object. Wrap the Nodeset val in a new xmlXPathObjectPtr Wraps the val string into an XPath object. Formats an error message. Build a node list tree copy of the XPointer result. This will drop Attributes and Namespace declarations. Evaluate the XPath Location Path in the given context. [8] Predicate ::= '[' PredicateExpr ']' [9] PredicateExpr ::= Expr Free the LocationSet compound (not the actual ranges !). add a new xmlXPathObjectPtr to an existing LocationSet If the location already exist in the set val is freed. Create a new xmlLocationSetPtr of type double and of value val Removes an xmlXPathObjectPtr from an existing LocationSet Merges two rangesets, all ranges from val2 are added to val1 Removes an entry from an existing LocationSet list. Create a new xmlXPathObjectPtr of type range using a single nodes Create a new XPointer context Create a new xmlXPathObjectPtr of type LocationSet and initialize it with all the nodes from set Create a new xmlXPathObjectPtr of type LocationSet and initialize it with the single range made of the two nodes start and end Create a new xmlXPathObjectPtr of type range Create a new xmlXPathObjectPtr of type range from a not to an object Create a new xmlXPathObjectPtr of type range from a node to a point Create a new xmlXPathObjectPtr of type range using 2 nodes Create a new xmlXPathObjectPtr of type range from a point to a node Create a new xmlXPathObjectPtr of type range using 2 Points Implement the range-to() XPointer function Wrap the LocationSet val in a new xmlXPathObjectPtr