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 DEBUG_MEMORY replaces the allocator with a collect and debug shell to the libc allocator. DEBUG_MEMORY should only be activated 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 automata interfaces are compiled in 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 Whether the regular expressions interfaces are compiled in Whether the Schemas validation interfaces are compiled in 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 Whether the Unicode related interfaces are compiled 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. Note that format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called 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. Note that format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called 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 needs 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 Enabled 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. Note that format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called Dump an XML node, recursive behaviour, children are printed too. Note that format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called 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. Deallocate a Schema Type structure.