<xsl:value-of select="concat(@name, ': ', summary)"/>

+ { + + + The content of this structure is not made public by the API. + + + + + + + + + + + : + + + + + + + + } + + ; + +

+ + + + + + + + + + + + ( + + void + + + + + + + + + ,
+ + + + + + + + + + )
+ + +

libxml2 Reference Manual

Libxml2 is the XML C parser and toolkit developed for the Gnome project +(but usable outside of the Gnome platform), it is free software available +under the MIT +License. XML itself is a metalanguage to design markup languages, i.e. +text language where semantic and structure are added to the content using +extra "markup" information enclosed between angle brackets. HTML is the most +well-known markup language. Though the library is written in C a variety of language bindings make it available in +other environments.

Libxml2 implements a number of existing standards related to markup +languages:

As a result the libxml2 API is very + large. If you get lost searching for some specific API use + the online search + engine hosted on xmlsoft.org + the libxml2 and libxslt project page.

+ libxml2 Reference Manual +

Libxml2 implements a number of existing standards related to markup +languages:

As a result the libxml2 API is very + large. If you get lost searching for some specific API use + the online search + engine hosted on xmlsoft.org + the libxml2 and libxslt project page.

DOCBparser: old DocBook SGML parser

+ DOCBparser +

interface for a DocBook SGML non-verifying parser This code is DEPRECATED, and should not be used anymore.

typedef xmlParserInputPtr docbParserInputPtr; +typedef xmlParserCtxt docbParserCtxt; +typedef xmlParserCtxtPtr docbParserCtxtPtr; +typedef xmlParserInput docbParserInput; +typedef xmlDocPtr docbDocPtr; +typedef xmlSAXHandler docbSAXHandler; +typedef xmlSAXHandlerPtr docbSAXHandlerPtr; +void docbFreeParserCtxt (docbParserCtxtPtr ctxt); +docbDocPtr docbParseDoc (xmlChar * cur,
const char * encoding); +docbParserCtxtPtr docbCreateFileParserCtxt (const char * filename,
const char * encoding); +docbDocPtr docbSAXParseFile (const char * filename,
const char * encoding,
docbSAXHandlerPtr sax,
void * userData); +docbDocPtr docbSAXParseDoc (xmlChar * cur,
const char * encoding,
docbSAXHandlerPtr sax,
void * userData); +docbParserCtxtPtr docbCreatePushParserCtxt (docbSAXHandlerPtr sax,
void * user_data,
const char * chunk,
int size,
const char * filename,
xmlCharEncoding enc); +int docbEncodeEntities (unsigned char * out,
int * outlen,
const unsigned char * in,
int * inlen,
int quoteChar); +docbDocPtr docbParseFile (const char * filename,
const char * encoding); +int docbParseDocument (docbParserCtxtPtr ctxt); +int docbParseChunk (docbParserCtxtPtr ctxt,
const char * chunk,
int size,
int terminate); +

Details

Typedef docbDocPtr

xmlDocPtr docbDocPtr;
+

Typedef docbParserCtxt

xmlParserCtxt docbParserCtxt;
+

Typedef docbParserCtxtPtr

xmlParserCtxtPtr docbParserCtxtPtr;
+

Typedef docbParserInput

xmlParserInput docbParserInput;
+

Typedef docbParserInputPtr

xmlParserInputPtr docbParserInputPtr;
+

Typedef docbSAXHandler

xmlSAXHandler docbSAXHandler;
+

Typedef docbSAXHandlerPtr

xmlSAXHandlerPtr docbSAXHandlerPtr;
+

docbCreateFileParserCtxt ()

docbParserCtxtPtr	docbCreateFileParserCtxt	(const char * filename, 
							 const char * encoding)

+

Create a parser context for a file content. Automatic support for ZLIB/Compress compressed document is provided by default if found at compile-time.

`filename`:	the filename
`encoding`:	the SGML document encoding, or NULL
`Returns`:	the new parser context or NULL

docbCreatePushParserCtxt ()

docbParserCtxtPtr	docbCreatePushParserCtxt	(docbSAXHandlerPtr sax, 
							 void * user_data, 
							 const char * chunk, 
							 int size, 
							 const char * filename, 
							 xmlCharEncoding enc)

+

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.

`sax`:	a SAX handler
`user_data`:	The user data returned on SAX callbacks
`chunk`:	a pointer to an array of chars
`size`:	number of chars in the array
`filename`:	an optional file name or URI
`enc`:	an optional encoding
`Returns`:	the new parser context or NULL

docbEncodeEntities ()

int	docbEncodeEntities		(unsigned char * out, 
					 int * outlen, 
					 const unsigned char * in, 
					 int * inlen, 
					 int quoteChar)

+

Take a block of UTF-8 chars in and try to convert it to an ASCII plus SGML entities block of chars out.

`out`:	a pointer to an array of bytes to store the result
`outlen`:	the length of @out
`in`:	a pointer to an array of UTF-8 chars
`inlen`:	the length of @in
`quoteChar`:	the quote character to escape (' or ") or zero.
`Returns`:	0 if success, -2 if the transcoding fails, or -1 otherwise The value of @inlen after return is the number of octets consumed as the return value is positive, else unpredictable. The value of @outlen after return is the number of octets consumed.

docbFreeParserCtxt ()

void	docbFreeParserCtxt		(docbParserCtxtPtr ctxt)

+

Free all the memory used by a parser context. However the parsed document in ctxt->myDoc is not freed.

ctxt: an SGML parser context

docbParseChunk ()

int	docbParseChunk			(docbParserCtxtPtr ctxt, 
					 const char * chunk, 
					 int size, 
					 int terminate)

+

Parse a Chunk of memory

`ctxt`:	an XML parser context
`chunk`:	an char array
`size`:	the size in byte of the chunk
`terminate`:	last chunk indicator
`Returns`:	zero if no error, the xmlParserErrors otherwise.

docbParseDoc ()

docbDocPtr	docbParseDoc		(xmlChar * cur, 
					 const char * encoding)

+

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

`cur`:	a pointer to an array of xmlChar
`encoding`:	a free form C string describing the SGML document encoding, or NULL
`Returns`:	the resulting document tree

docbParseDocument ()

int	docbParseDocument		(docbParserCtxtPtr ctxt)

+

parse an SGML document (and build a tree if using the standard SAX interface).

`ctxt`:	an SGML parser context
`Returns`:	0, -1 in case of error. the parser context is augmented as a result of the parsing.

docbParseFile ()

docbDocPtr	docbParseFile		(const char * filename, 
					 const char * encoding)

+

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.

`filename`:	the filename
`encoding`:	a free form C string describing document encoding, or NULL
`Returns`:	the resulting document tree

docbSAXParseDoc ()

docbDocPtr	docbSAXParseDoc		(xmlChar * cur, 
					 const char * encoding, 
					 docbSAXHandlerPtr sax, 
					 void * userData)

+

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.

`cur`:	a pointer to an array of xmlChar
`encoding`:	a free form C string describing the SGML document encoding, or NULL
`sax`:	the SAX handler block
`userData`:	if using SAX, this pointer will be provided on callbacks.
`Returns`:	the resulting document tree

docbSAXParseFile ()

docbDocPtr	docbSAXParseFile	(const char * filename, 
					 const char * encoding, 
					 docbSAXHandlerPtr sax, 
					 void * userData)

+

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.

`filename`:	the filename
`encoding`:	a free form C string describing the SGML document encoding, or NULL
`sax`:	the SAX handler block
`userData`:	if using SAX, this pointer will be provided on callbacks.
`Returns`:	the resulting document tree

Structure

Typedef

Variable

Enum

Macro

()

Function type

libxml2 API Modules