From c3e4f3c26035bc93a69e5aa2ad435809e8be8a4e Mon Sep 17 00:00:00 2001 From: Mike Hommey Date: Thu, 10 Sep 2009 22:10:39 +0200 Subject: Import upstream version 2.7.4 --- doc/html/libxml-parser.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'doc/html/libxml-parser.html') diff --git a/doc/html/libxml-parser.html b/doc/html/libxml-parser.html index 83db4d9..b35cac0 100644 --- a/doc/html/libxml-parser.html +++ b/doc/html/libxml-parser.html @@ -10,7 +10,7 @@ A:link, A:visited, A:active { text-decoration: underline } Module parser from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module parser from libxml2

API Menu
API Indexes
Related links
PrevnanohttpUpAPI documentationHomeThe XML C parser and toolkit of GnomeparserInternalsNext

Interfaces, constants and types related to the XML parser

Table of Contents

#define XML_COMPLETE_ATTRS
#define XML_DEFAULT_VERSION
#define XML_DETECT_IDS
#define XML_SAX2_MAGIC
#define XML_SKIP_IDS
Enum xmlFeature
+    Module parser from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo
Module parser from libxml2
API Menu
API Indexes
Related links
PrevnanohttpUpAPI documentationHomeThe XML C parser and toolkit of GnomeparserInternalsNext
Interfaces, constants and types related to the XML parser 
Table of Contents
#define XML_COMPLETE_ATTRS
#define XML_DEFAULT_VERSION
#define XML_DETECT_IDS
#define XML_SAX2_MAGIC
#define XML_SKIP_IDS
Enum xmlFeature
 
Enum xmlParserInputState
 
Enum xmlParserMode
 
Structure xmlParserNodeInfo
struct _xmlParserNodeInfo
@@ -169,7 +169,7 @@ void	xmlParserInputDeallocate	(xmlDocPtr	xmlReadFile		(const char * filename, 
					 const char * encoding, 
					 int options)

 
xmlDocPtr	xmlReadIO		(xmlInputReadCallback ioread, 
					 xmlInputCloseCallback ioclose, 
					 void * ioctx, 
					 const char * URL, 
					 const char * encoding, 
					 int options)

 
xmlDocPtr	xmlReadMemory		(const char * buffer, 
					 int size, 
					 const char * URL, 
					 const char * encoding, 
					 int options)

-
xmlDocPtr	xmlRecoverDoc		(xmlChar * cur)

+
xmlDocPtr	xmlRecoverDoc		(const xmlChar * cur)

 
xmlDocPtr	xmlRecoverFile		(const char * filename)

 
xmlDocPtr	xmlRecoverMemory	(const char * buffer, 
					 int size)

 
xmlDtdPtr	xmlSAXParseDTD		(xmlSAXHandlerPtr sax, 
					 const xmlChar * ExternalID, 
					 const xmlChar * SystemID)

@@ -409,7 +409,7 @@ void	warningSAXFunc			(void * ctx, 
					 const char * msg, 
					 ...
 
Function: xmlByteConsumed
long	xmlByteConsumed			(xmlParserCtxtPtr ctxt)

 
This function provides the current index of the parser relative to the start of the current entity. This function is computed in bytes from the beginning starting at zero and finishing at the size in byte of the file if parsing a file. The function is of constant cost if the input is UTF-8 but can be costly if run on non-UTF-8 input.

 
ctxt:an XML parser context
Returns:the index in bytes from the beginning of the entity or -1 in case the index could not be computed.
Function: xmlCleanupParser
void	xmlCleanupParser		(void)

-
This function name is somewhat misleading. It does not clean up parser state, it cleans up memory allocated by the library itself. It is a cleanup function for the XML library. It tries to reclaim all related global memory allocated for the library processing. It doesn't deallocate any document related memory. One should call xmlCleanupParser() only when the process has finished using the library and all XML/HTML documents built with it. See also xmlInitParser() which has the opposite function of preparing the library for operations.

+
This function name is somewhat misleading. It does not clean up parser state, it cleans up memory allocated by the library itself. It is a cleanup function for the XML library. It tries to reclaim all related global memory allocated for the library processing. It doesn't deallocate any document related memory. One should call xmlCleanupParser() only when the process has finished using the library and all XML/HTML documents built with it. See also xmlInitParser() which has the opposite function of preparing the library for operations. WARNING: if your application is multithreaded or has plugin support calling this may crash the application if another thread or a plugin is still using libxml2. It's sometimes very hard to guess if libxml2 is in use in the application, some libraries or plugins may use it without notice. In case of doubt abstain from calling this function or do it just before calling exit() to avoid leak reports from valgrind !

 
Function: xmlClearNodeInfoSeq
void	xmlClearNodeInfoSeq		(xmlParserNodeInfoSeqPtr seq)

 
-- Clear (release memory and reinitialize) node info sequence

 
seq:a node info sequence pointer
Function: xmlClearParserCtxt
void	xmlClearParserCtxt		(xmlParserCtxtPtr ctxt)

@@ -518,7 +518,7 @@ void	xmlParserInputDeallocate	(xmlChar
parse an XML document from I/O functions and source and build a tree.

 
ioread:an I/O read function
ioclose:an I/O close function
ioctx:an I/O handler
URL:the base URL to use for the document
encoding:the document encoding, or NULL
options:a combination of xmlParserOption
Returns:the resulting document tree
Function: xmlReadMemory
xmlDocPtr	xmlReadMemory		(const char * buffer, 
					 int size, 
					 const char * URL, 
					 const char * encoding, 
					 int options)

 
parse an XML in-memory document and build a tree.

-
buffer:a pointer to a char array
size:the size of the array
URL:the base URL to use for the document
encoding:the document encoding, or NULL
options:a combination of xmlParserOption
Returns:the resulting document tree
Function: xmlRecoverDoc
xmlDocPtr	xmlRecoverDoc		(xmlChar * cur)

+
buffer:a pointer to a char array
size:the size of the array
URL:the base URL to use for the document
encoding:the document encoding, or NULL
options:a combination of xmlParserOption
Returns:the resulting document tree
Function: xmlRecoverDoc
xmlDocPtr	xmlRecoverDoc		(const xmlChar * cur)

 
parse an XML in-memory document and build a tree. In the case the document is not Well Formed, a attempt to build a tree is tried anyway

 
cur:a pointer to an array of xmlChar
Returns:the resulting document tree or NULL in case of failure
Function: xmlRecoverFile
xmlDocPtr	xmlRecoverFile		(const char * filename)

 
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, it attempts to build a tree anyway

-- 
cgit v1.2.3