diff --git a/doc/APIchunk10.html b/doc/APIchunk10.html index f3ea4f2e..6e13a26f 100644 --- a/doc/APIchunk10.html +++ b/doc/APIchunk10.html @@ -586,7 +586,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlGetUTF8Char
xmlParserInputBufferRead
consuming
xmlScanName
-
contain
xmlParseAttribute
+
contain
xmlNewTextChild
+xmlParseAttribute
xmlParseEntityRef
xmlParsePEReference
xmlParseSDDecl
diff --git a/doc/APIchunk12.html b/doc/APIchunk12.html index f6133a45..82d051da 100644 --- a/doc/APIchunk12.html +++ b/doc/APIchunk12.html @@ -154,6 +154,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSprintfElementContent
enhancements
htmlNodeStatus
enough
xmlBuildQName
+
ensure
xmlNewTextChild
entire
xmlCleanupInputCallbacks
xmlCleanupOutputCallbacks
entities:
xmlParseEntityRef
@@ -256,6 +257,7 @@ A:link, A:visited, A:active { text-decoration: underline }
escaped
xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
+xmlNewTextChild
xmlParseCDSect
xmlParseCharData
xmlSaveUri
diff --git a/doc/APIchunk14.html b/doc/APIchunk14.html index 76e06c4b..cfb13d6e 100644 --- a/doc/APIchunk14.html +++ b/doc/APIchunk14.html @@ -139,6 +139,7 @@ A:link, A:visited, A:active { text-decoration: underline }
greater
xmlXPathCompareValues
xmlXPathFloorFunction
xmlXPathSubstringFunction
+
greater-than
xmlNewTextChild
group
_xmlSchemaAttribute
_xmlSchemaAttributeGroup
ftpListCallback
diff --git a/doc/APIchunk16.html b/doc/APIchunk16.html index cf10ba88..6c2b50ca 100644 --- a/doc/APIchunk16.html +++ b/doc/APIchunk16.html @@ -156,6 +156,7 @@ A:link, A:visited, A:active { text-decoration: underline }
less
xmlXPathCeilingFunction
xmlXPathCompareValues
xmlXPathSubstringFunction
+
less-than
xmlNewTextChild
level
XML_SCHEMAS_ELEM_TOPLEVEL
_xmlDoc
xmlC14NDocSave
diff --git a/doc/APIchunk17.html b/doc/APIchunk17.html index 73b81138..e9019228 100644 --- a/doc/APIchunk17.html +++ b/doc/APIchunk17.html @@ -198,6 +198,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSetBufferAllocationScheme
xmlTextReaderClose
xmlTextReaderGetRemainder
+
might
xmlNewTextChild
migrate
xmlEncodeEntities
minimal
xmlAutomataNewCounter
minimum
xmlAutomataNewCountTrans
diff --git a/doc/APIchunk18.html b/doc/APIchunk18.html index 7564bba7..97715fb6 100644 --- a/doc/APIchunk18.html +++ b/doc/APIchunk18.html @@ -79,9 +79,9 @@ A:link, A:visited, A:active { text-decoration: underline } xmlCreatePushParserCtxt
xmlGetNsList
xmlInitCharEncodingHandlers
-xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
+xmlNewTextChild
xmlParseEntityRef
xmlParserHandleReference
xmlValidGetValidElements
@@ -94,9 +94,7 @@ A:link, A:visited, A:active { text-decoration: underline } xlinkIsLink
xmlGetBufferAllocationScheme
xmlLoadSGMLSuperCatalog
-xmlNewChild
xmlNewNodeEatName
-xmlNewTextChild
xmlParseElementChildrenContentDecl
xmlParseElementMixedContentDecl
xmlReconciliateNs
diff --git a/doc/APIchunk20.html b/doc/APIchunk20.html index db92216f..cd7a1134 100644 --- a/doc/APIchunk20.html +++ b/doc/APIchunk20.html @@ -279,6 +279,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlParserInputRead
xmlTextReaderPreservePattern
preserved
HTML_PRESERVE_NODE
+xmlNewTextChild
xmlParserInputBufferGrow
preserving
xmlNodeGetSpacePreserve
xmlNodeSetSpacePreserve
diff --git a/doc/APIchunk21.html b/doc/APIchunk21.html index 20b664b2..6db965d6 100644 --- a/doc/APIchunk21.html +++ b/doc/APIchunk21.html @@ -375,6 +375,7 @@ A:link, A:visited, A:active { text-decoration: underline }
replaced
xmlHashUpdateEntry
xmlHashUpdateEntry2
xmlHashUpdateEntry3
+xmlNewTextChild
xmlXPathTranslateFunction
replacement
xmlACatalogAdd
xmlCatalogAdd
@@ -398,6 +399,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlCreatePushParserCtxt
repr
xmlSchemaValidateFacet
representation
_htmlElemDesc
+
representations
xmlNewTextChild
represented
xmlParseCharData
xmlXPathStringFunction
represented:
_htmlElemDesc
@@ -424,7 +426,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlGetLineNo
xmlRelaxNGValidatePushElement
requred
xmlC14NDocSave
-
reserved
xmlURIEscapeStr
+
reserved
xmlNewTextChild
+xmlURIEscapeStr
reset
initGenericErrorDefaultFunc
xmlNodeSetBase
xmlNodeSetName
diff --git a/doc/APIchunk22.html b/doc/APIchunk22.html index 77f11594..c78aadcb 100644 --- a/doc/APIchunk22.html +++ b/doc/APIchunk22.html @@ -267,6 +267,7 @@ A:link, A:visited, A:active { text-decoration: underline } _xmlParserCtxt
signature
xmlShellCmd
xmlShellReadlineFunc
+
signs
xmlNewTextChild
similar
xmlGetNoNsProp
xmlNewNs
xmlShell
@@ -732,7 +733,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlAutomataNewOnceTrans
successive
xmlAutomataNewCountTrans
xmlAutomataNewOnceTrans
-
such
xmlParseEntityRef
+
such
xmlNewTextChild
+xmlParseEntityRef
xmlXPathLangFunction
xmlXPathNodeSetFreeNs
xmlXPathRoundFunction
diff --git a/doc/APIchunk23.html b/doc/APIchunk23.html index 5cd6cb96..f712b251 100644 --- a/doc/APIchunk23.html +++ b/doc/APIchunk23.html @@ -108,6 +108,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlEncodeEntities
xmlEncodeEntitiesReentrant
xmlLoadCatalogs
+xmlNewTextChild
xmlNodeListGetRawString
xmlNodeListGetString
xmlParseEntityRef
diff --git a/doc/APIchunk25.html b/doc/APIchunk25.html index 3503d93e..7a80e451 100644 --- a/doc/APIchunk25.html +++ b/doc/APIchunk25.html @@ -241,6 +241,7 @@ A:link, A:visited, A:active { text-decoration: underline }
xmlNewMutex
xmlNewMutex
xmlNewNode
xmlNewNodeEatName
xmlNewTextChild
xmlNewChild
+xmlNewTextChild
xmlNewTextWriter
xmlNewTextWriter
xmlNewTextWriterDoc
xmlNewTextWriterFilename
diff --git a/doc/APIchunk7.html b/doc/APIchunk7.html index 7d96b513..d37da2fb 100644 --- a/doc/APIchunk7.html +++ b/doc/APIchunk7.html @@ -224,7 +224,6 @@ A:link, A:visited, A:active { text-decoration: underline } xmlIsExtender
xmlIsIdeographic
xmlIsPubidChar
-xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
xmlNewNodeEatName
diff --git a/doc/APIchunk8.html b/doc/APIchunk8.html index 20882d97..8a61b932 100644 --- a/doc/APIchunk8.html +++ b/doc/APIchunk8.html @@ -435,7 +435,6 @@ A:link, A:visited, A:active { text-decoration: underline } xmlCheckUTF8
xmlCreatePushParserCtxt
xmlKeepBlanksDefault
-xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
xmlSearchNs
@@ -465,6 +464,7 @@ A:link, A:visited, A:active { text-decoration: underline }
allows
htmlAutoCloseTag
htmlIsAutoClosed
xmlCatalogAdd
+xmlNewChild
xmlTextReaderConstString
already
_xmlParserInput
xmlAddNextSibling
@@ -506,6 +506,7 @@ A:link, A:visited, A:active { text-decoration: underline }
amp
xmlParseEntityRef
xmlParseSDDecl
xmlParserHandleReference
+
ampersand
xmlNewTextChild
analysis
_xmlParserCtxt
_xmlValidCtxt
analyze
xmlParseURI
@@ -539,7 +540,8 @@ A:link, A:visited, A:active { text-decoration: underline }
apos
xmlParseEntityRef
xmlParseSDDecl
xmlParserHandleReference
-
appear
xmlParseAttributeType
+
appear
xmlNewTextChild
+xmlParseAttributeType
xmlParseElementMixedContentDecl
xmlParsePEReference
xmlParseSDDecl
@@ -641,6 +643,7 @@ A:link, A:visited, A:active { text-decoration: underline }
autoclosed
htmlIsAutoClosed
autogeneration
xmlKeepBlanksDefault
automatically
xmlCharEncOutFunc
+xmlNewTextChild
autoreference
_xmlDoc
avoiding
xmlTextReaderNext
xmlTextReaderNextSibling
diff --git a/doc/APIchunk9.html b/doc/APIchunk9.html index d1d14e1e..334406c2 100644 --- a/doc/APIchunk9.html +++ b/doc/APIchunk9.html @@ -237,7 +237,6 @@ A:link, A:visited, A:active { text-decoration: underline } xmlCharEncFirstLine
xmlCheckUTF8
xmlCleanupParser
-xmlNewChild
xmlNewDocNode
xmlNewDocNodeEatName
xmlParsePEReference
diff --git a/doc/APIconstructors.html b/doc/APIconstructors.html index ac23e72d..5220d777 100644 --- a/doc/APIconstructors.html +++ b/doc/APIconstructors.html @@ -71,8 +71,8 @@ A:link, A:visited, A:active { text-decoration: underline } htmlReadDoc
htmlNewDoc
htmlReadFd
-

Type htmlParserCtxtPtr:

htmlCreatePushParserCtxt
-htmlCreateFileParserCtxt
+

Type htmlParserCtxtPtr:

htmlCreateFileParserCtxt
+htmlCreatePushParserCtxt
htmlCreateMemoryParserCtxt

Type htmlStatus:

htmlElementStatusHere
htmlAttrAllowed
@@ -82,12 +82,12 @@ A:link, A:visited, A:active { text-decoration: underline }

Type unsigned long:

xmlParserFindNodeInfoIndex

Type void *:

xmlNanoHTTPMethod
xmlMemRealloc
-xmlLinkGetData
xmlHashLookup3
xmlReallocFunc
xmlNanoFTPConnectTo
xmlOutputOpenCallback
xmlHashLookup2
+xmlLinkGetData
xmlHashLookup
xmlHashQLookup
xmlListReverseSearch
@@ -126,9 +126,9 @@ A:link, A:visited, A:active { text-decoration: underline } xmlNewNsPropEatName
xmlCopyProp
xmlSetProp
-

Type xmlAttributePtr:

xmlAddAttributeDecl
+

Type xmlAttributePtr:

xmlGetDtdAttrDesc
+xmlAddAttributeDecl
xmlGetDtdQAttrDesc
-xmlGetDtdAttrDesc

Type xmlAttributeTablePtr:

xmlCopyAttributeTable

Type xmlAutomataPtr:

xmlNewAutomata

Type xmlAutomataStatePtr:

xmlAutomataNewCountedTrans
@@ -149,8 +149,8 @@ A:link, A:visited, A:active { text-decoration: underline }

Type xmlCatalogAllow:

xmlCatalogGetDefaults

Type xmlCatalogPrefer:

xmlCatalogSetDefaultPrefer

Type xmlCatalogPtr:

xmlLoadSGMLSuperCatalog
-xmlNewCatalog
xmlLoadACatalog
+xmlNewCatalog

Type xmlChar:

xmlPopInput

Type xmlChar *:

xmlNodeGetBase
xmlScanName
@@ -178,7 +178,6 @@ A:link, A:visited, A:active { text-decoration: underline } xmlStringDecodeEntities
xmlParseEncName
xmlTextReaderPrefix
-xmlDecodeEntities
xmlXPathCastNumberToString
xmlParseNmtoken
xmlTextReaderLocatorBaseURI
@@ -190,6 +189,7 @@ A:link, A:visited, A:active { text-decoration: underline } xmlEncodeSpecialChars
xmlURIEscapeStr
xmlGetNsProp
+xmlDecodeEntities
xmlXPathCastNodeToString
xmlNamespaceParseNCName
xmlCatalogResolveURI
@@ -237,8 +237,8 @@ A:link, A:visited, A:active { text-decoration: underline }

Type xmlCharEncoding:

xmlDetectCharEncoding
xmlParseCharEncoding

Type xmlCharEncodingHandlerPtr:

xmlGetCharEncodingHandler
-xmlNewCharEncodingHandler
xmlFindCharEncodingHandler
+xmlNewCharEncodingHandler

Type xmlDeregisterNodeFunc:

xmlThrDefDeregisterNodeDefault
xmlDeregisterNodeDefault

Type xmlDictPtr:

xmlDictCreate
@@ -247,8 +247,8 @@ A:link, A:visited, A:active { text-decoration: underline } xmlSAXParseMemoryWithData
xmlSAXParseEntity
xmlParseEntity
-xmlSAXParseFileWithData
xmlRecoverDoc
+xmlSAXParseFileWithData
xmlReadDoc
xmlReadMemory
xmlCtxtReadIO
@@ -256,13 +256,13 @@ A:link, A:visited, A:active { text-decoration: underline } xmlReadFile
xmlRecoverFile
xmlSAXParseDoc
+xmlParseCatalogFile
xmlCtxtReadFile
xmlCtxtReadFd
xmlReadIO
xmlCopyDoc
xmlCtxtReadMemory
xmlReadFd
-xmlParseCatalogFile
xmlCtxtReadDoc
xmlParseMemory
xmlSAXParseFile
@@ -406,9 +406,9 @@ A:link, A:visited, A:active { text-decoration: underline } xmlCreateIOParserCtxt
xmlCreateFileParserCtxt
xmlCreateDocParserCtxt
-xmlCreateEntityParserCtxt
xmlCreatePushParserCtxt
xmlNewParserCtxt
+xmlCreateEntityParserCtxt

Type xmlParserInputBufferPtr:

xmlParserInputBufferCreateFilename
xmlParserInputBufferCreateMem
xmlAllocParserInputBuffer
@@ -452,8 +452,8 @@ A:link, A:visited, A:active { text-decoration: underline }

Type xmlSchemaValidCtxtPtr:

xmlSchemaNewValidCtxt

Type xmlTextReaderPtr:

xmlReaderForFile
xmlReaderForIO
-xmlNewTextReader
xmlReaderForFd
+xmlNewTextReader
xmlReaderWalker
xmlNewTextReaderFilename
xmlReaderForDoc
diff --git a/doc/html/libxml-DOCBparser.html b/doc/html/libxml-DOCBparser.html index 54dab0be..4e9c6545 100644 --- a/doc/html/libxml-DOCBparser.html +++ b/doc/html/libxml-DOCBparser.html @@ -32,7 +32,7 @@ A:link, A:visited, A:active { text-decoration: underline }

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

Function: 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.

Function: docbParseFile

docbDocPtr	docbParseFile		(const char * filename, 
const char * encoding)
+
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.

Function: 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

Function: docbParseDocument

int	docbParseDocument		(docbParserCtxtPtr ctxt)

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

diff --git a/doc/html/libxml-HTMLparser.html b/doc/html/libxml-HTMLparser.html index b64a9c42..295d5f0f 100644 --- a/doc/html/libxml-HTMLparser.html +++ b/doc/html/libxml-HTMLparser.html @@ -10,7 +10,7 @@ A:link, A:visited, A:active { text-decoration: underline } Module HTMLparser from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module HTMLparser from libxml2

API Menu
API Indexes
Related links

this module implements an HTML 4.0 non-verifying parser with API compatible with the XML parser ones. It should be able to parse "real world" HTML, even if severely broken from a specification point of view.

Table of Contents

#define htmlDefaultSubelement
#define htmlElementAllowedHereDesc
#define htmlRequiredAttrs
Typedef xmlDocPtr htmlDocPtr
+    Module HTMLparser from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module HTMLparser from libxml2

API Menu
API Indexes
Related links

this module implements an HTML 4.0 non-verifying parser with API compatible with the XML parser ones. It should be able to parse "real world" HTML, even if severely broken from a specification point of view.

Table of Contents

#define htmlDefaultSubelement
#define htmlElementAllowedHereDesc
#define htmlRequiredAttrs
Typedef xmlDocPtr htmlDocPtr
 
Structure htmlElemDesc
struct _htmlElemDesc
Typedef htmlElemDesc * htmlElemDescPtr
 
Structure htmlEntityDesc
struct _htmlEntityDesc @@ -129,7 +129,7 @@ A:link, A:visited, A:active { text-decoration: underline }

Checks whether an HTML element may be a direct child of a parent element. and if so whether it is valid or deprecated.

parent:HTML parent element
elt:HTML element
Returns:one of HTML_VALID, HTML_DEPRECATED, HTML_INVALID

Function: htmlEncodeEntities

int	htmlEncodeEntities		(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 HTML 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.

Function: htmlEntityLookup

const htmlEntityDesc *	htmlEntityLookup	(const xmlChar * name)
+
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.

Function: htmlEntityLookup

const htmlEntityDesc *	htmlEntityLookup	(const xmlChar * name)

Lookup the given entity in EntitiesTable TODO: the linear scan is really ugly, an hash table is really needed.

name:the entity name
Returns:the associated htmlEntityDescPtr if found, NULL otherwise.

Function: htmlEntityValueLookup

const htmlEntityDesc *	htmlEntityValueLookup	(unsigned int value)

Lookup the given entity in EntitiesTable TODO: the linear scan is really ugly, an hash table is really needed.

diff --git a/doc/html/libxml-HTMLtree.html b/doc/html/libxml-HTMLtree.html index 43b66555..179181ba 100644 --- a/doc/html/libxml-HTMLtree.html +++ b/doc/html/libxml-HTMLtree.html @@ -60,7 +60,7 @@ A:link, A:visited, A:active { text-decoration: underline }
buf:the HTML buffer output
doc:the document
cur:the current node
encoding:the encoding string
format:should formatting spaces been added

Function: htmlNodeDumpOutput

void	htmlNodeDumpOutput		(xmlOutputBufferPtr buf, 
xmlDocPtr doc,
xmlNodePtr cur,
const char * encoding)

Dump an HTML node, recursive behaviour,children are printed too, and formatting returns/spaces are added.

buf:the HTML buffer output
doc:the document
cur:the current node
encoding:the encoding string

Function: htmlSaveFile

int	htmlSaveFile			(const char * filename, 
xmlDocPtr cur)
-

Dump an HTML document to a file. If @filename is "-" the stdout file is used.

+

Dump an HTML document to a file. If @filename is "-" the stdout file is used.

filename:the filename (or URL)
cur:the document
Returns:the number of byte written or -1 in case of failure.

Function: htmlSaveFileEnc

int	htmlSaveFileEnc			(const char * filename, 
xmlDocPtr cur,
const char * encoding)

Dump an HTML document to a file using a given encoding and formatting returns/spaces are added.

filename:the filename
cur:the document
encoding:the document encoding
Returns:the number of byte written or -1 in case of failure.

Function: htmlSaveFileFormat

int	htmlSaveFileFormat		(const char * filename, 
xmlDocPtr cur,
const char * encoding,
int format)
diff --git a/doc/html/libxml-SAX.html b/doc/html/libxml-SAX.html index 7c298523..6295bba6 100644 --- a/doc/html/libxml-SAX.html +++ b/doc/html/libxml-SAX.html @@ -73,7 +73,7 @@ A:link, A:visited, A:active { text-decoration: underline }
hdlr:the SAX handler

Function: setDocumentLocator

void	setDocumentLocator		(void * ctx, 
xmlSAXLocatorPtr loc)

Receive the document locator at startup, actually xmlDefaultSAXLocator Everything is available on the context, so this is useless in our case. DEPRECATED

ctx:the user data (XML parser context)
loc:A SAX Locator

Function: getPublicId

const xmlChar *	getPublicId		(void * ctx)
-

Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN" DEPRECATED: use xmlSAX2GetPublicId()

+

Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN" DEPRECATED: use xmlSAX2GetPublicId()

ctx:the user data (XML parser context)
Returns:a xmlChar *

Function: getEntity

xmlEntityPtr	getEntity		(void * ctx, 
const xmlChar * name)

Get an entity by name DEPRECATED: use xmlSAX2GetEntity()

ctx:the user data (XML parser context)
name:The entity name
Returns:the xmlEntityPtr if found.

Function: characters

void	characters			(void * ctx, 
const xmlChar * ch,
int len)
diff --git a/doc/html/libxml-SAX2.html b/doc/html/libxml-SAX2.html index c6bf5e0d..f0e469bf 100644 --- a/doc/html/libxml-SAX2.html +++ b/doc/html/libxml-SAX2.html @@ -93,7 +93,7 @@ A:link, A:visited, A:active { text-decoration: underline }
ctx:
Returns:

Function: xmlSAX2GetParameterEntity

xmlEntityPtr	xmlSAX2GetParameterEntity	(void * ctx, 
const xmlChar * name)

Get a parameter entity by name

ctx:the user data (XML parser context)
name:The entity name
Returns:the xmlEntityPtr if found.

Function: xmlSAX2GetPublicId

const xmlChar *	xmlSAX2GetPublicId	(void * ctx)
-

Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN"

+

Provides the public ID e.g. "-//SGMLSOURCE//DTD DEMO//EN"

ctx:the user data (XML parser context)
Returns:a xmlChar *

Function: xmlSAX2GetSystemId

const xmlChar *	xmlSAX2GetSystemId	(void * ctx)

Provides the system ID, basically URL or filename e.g. http://www.sgmlsource.com/dtds/memo.dtd

ctx:the user data (XML parser context)
Returns:a xmlChar *

Function: xmlSAX2GlobalNamespace

void	xmlSAX2GlobalNamespace		(void * ctx, 
const xmlChar * href,
const xmlChar * prefix)
diff --git a/doc/html/libxml-c14n.html b/doc/html/libxml-c14n.html index bf07602f..2b38b3dd 100644 --- a/doc/html/libxml-c14n.html +++ b/doc/html/libxml-c14n.html @@ -10,7 +10,7 @@ A:link, A:visited, A:active { text-decoration: underline } Module c14n from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module c14n from libxml2

API Menu
API Indexes
Related links

the c14n modules provides a "Canonical XML" implementation

Table of Contents

int	xmlC14NDocDumpMemory		(xmlDocPtr doc, 
xmlNodeSetPtr nodes,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
xmlChar ** doc_txt_ptr)
+ Module c14n from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module c14n from libxml2

API Menu
API Indexes
Related links

the c14n modules provides a "Canonical XML" implementation

Table of Contents

int	xmlC14NDocDumpMemory		(xmlDocPtr doc, 
xmlNodeSetPtr nodes,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
xmlChar ** doc_txt_ptr)
int	xmlC14NDocSave			(xmlDocPtr doc, 
xmlNodeSetPtr nodes,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
const char * filename,
int compression)
int	xmlC14NDocSaveTo		(xmlDocPtr doc, 
xmlNodeSetPtr nodes,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
xmlOutputBufferPtr buf)
int	xmlC14NExecute			(xmlDocPtr doc, 
xmlC14NIsVisibleCallback is_visible_callback,
void * user_data,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
xmlOutputBufferPtr buf)
@@ -19,13 +19,13 @@ int xmlC14NIsVisibleCallback (void * use

Description

Function: xmlC14NDocDumpMemory

int	xmlC14NDocDumpMemory		(xmlDocPtr doc, 
xmlNodeSetPtr nodes,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
xmlChar ** doc_txt_ptr)
-

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 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)

doc:the XML document for canonization
nodes:the nodes set to be included in the canonized image or NULL if all document nodes should be included
exclusive:the exclusive flag (0 - non-exclusive canonicalization; otherwise - exclusive canonicalization)
inclusive_ns_prefixes:the list of inclusive namespace prefixes ended with a NULL or NULL if there is no inclusive namespaces (only for exclusive canonicalization, ignored otherwise)
with_comments:include comments in the result (!=0) or not (==0)
doc_txt_ptr:the memory pointer for allocated canonical XML text; the caller of this functions is responsible for calling xmlFree() to free allocated memory
Returns:the number of bytes written on success or a negative value on fail

Function: xmlC14NDocSave

int	xmlC14NDocSave			(xmlDocPtr doc, 
xmlNodeSetPtr nodes,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
const char * filename,
int compression)
-

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 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)

doc:the XML document for canonization
nodes:the nodes set to be included in the canonized image or NULL if all document nodes should be included
exclusive:the exclusive flag (0 - non-exclusive canonicalization; otherwise - exclusive canonicalization)
inclusive_ns_prefixes:the list of inclusive namespace prefixes ended with a NULL or NULL if there is no inclusive namespaces (only for exclusive canonicalization, ignored otherwise)
with_comments:include comments in the result (!=0) or not (==0)
filename:the filename to store canonical XML image
compression:the compression level (zlib requred): -1 - libxml default, 0 - uncompressed, >0 - compression level
Returns:the number of bytes written success or a negative value on fail

Function: xmlC14NDocSaveTo

int	xmlC14NDocSaveTo		(xmlDocPtr doc, 
xmlNodeSetPtr nodes,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
xmlOutputBufferPtr buf)
-

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)

+

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)

doc:the XML document for canonization
nodes:the nodes set to be included in the canonized image or NULL if all document nodes should be included
exclusive:the exclusive flag (0 - non-exclusive canonicalization; otherwise - exclusive canonicalization)
inclusive_ns_prefixes:the list of inclusive namespace prefixes ended with a NULL or NULL if there is no inclusive namespaces (only for exclusive canonicalization, ignored otherwise)
with_comments:include comments in the result (!=0) or not (==0)
buf:the output buffer to store canonical XML; this buffer MUST have encoder==NULL because C14N requires UTF-8 output
Returns:non-negative value on success or a negative value on fail

Function: xmlC14NExecute

int	xmlC14NExecute			(xmlDocPtr doc, 
xmlC14NIsVisibleCallback is_visible_callback,
void * user_data,
int exclusive,
xmlChar ** inclusive_ns_prefixes,
int with_comments,
xmlOutputBufferPtr buf)
-

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)

+

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)

doc:the XML document for canonization
is_visible_callback:the function to use to determine is node visible or not
user_data:the first parameter for @is_visible_callback function (in most cases, it is nodes set)
exclusive:the exclusive flag (0 - non-exclusive canonicalization; otherwise - exclusive canonicalization)
inclusive_ns_prefixes:the list of inclusive namespace prefixes ended with a NULL or NULL if there is no inclusive namespaces (only for exclusive canonicalization, ignored otherwise)
with_comments:include comments in the result (!=0) or not (==0)
buf:the output buffer to store canonical XML; this buffer MUST have encoder==NULL because C14N requires UTF-8 output
Returns:non-negative value on success or a negative value on fail

Function type: xmlC14NIsVisibleCallback

Function type: xmlC14NIsVisibleCallback
 int	xmlC14NIsVisibleCallback	(void * user_data, 
xmlNodePtr node,
xmlNodePtr parent)

user_data:
node:
parent:
Returns:

diff --git a/doc/html/libxml-debugXML.html b/doc/html/libxml-debugXML.html index 0aeab114..def6a361 100644 --- a/doc/html/libxml-debugXML.html +++ b/doc/html/libxml-debugXML.html @@ -56,7 +56,7 @@ char * xmlShellReadlineFunc (char * prompt) xmlShellReadlineFunc input }

Function: xmlBoolToText

const char *	xmlBoolToText		(int boolval)

Convenient way to turn bool into text

-
boolval:a bool to turn into text
Returns:a pointer to either "True" or "False"

Function: xmlDebugDumpAttr

void	xmlDebugDumpAttr		(FILE * output, 
xmlAttrPtr attr,
int depth)
+
boolval:a bool to turn into text
Returns:a pointer to either "True" or "False"

Function: xmlDebugDumpAttr

void	xmlDebugDumpAttr		(FILE * output, 
xmlAttrPtr attr,
int depth)

Dumps debug information for the attribute

output:the FILE * for the output
attr:the attribute
depth:the indentation level.

Function: xmlDebugDumpAttrList

void	xmlDebugDumpAttrList		(FILE * output, 
xmlAttrPtr attr,
int depth)

Dumps debug information for the attribute list

@@ -83,20 +83,20 @@ char * xmlShellReadlineFunc (char * prompt)
output:the FILE * for the output
node:the node to dump

Function: xmlShell

void	xmlShell			(xmlDocPtr doc, 
char * filename,
xmlShellReadlineFunc input,
FILE * output)

Implements the XML shell This allow to load, validate, view, modify and save a document using a environment similar to a UNIX commandline.

doc:the initial document
filename:the output buffer
input:the line reading function
output:the output FILE*, defaults to stdout if NULL

Function: xmlShellBase

int	xmlShellBase			(xmlShellCtxtPtr ctxt, 
char * arg,
xmlNodePtr node,
xmlNodePtr node2)
-

Implements the XML shell function "base" dumps the current XML base of the node

+

Implements the XML shell function "base" dumps the current XML base of the node

ctxt:the shell context
arg:unused
node:a node
node2:unused
Returns:0

Function: xmlShellCat

int	xmlShellCat			(xmlShellCtxtPtr ctxt, 
char * arg,
xmlNodePtr node,
xmlNodePtr node2)
-

Implements the XML shell function "cat" dumps the serialization node content (XML or HTML).

+

Implements the XML shell function "cat" dumps the serialization node content (XML or HTML).

ctxt:the shell context
arg:unused
node:a node
node2:unused
Returns:0

Function type: xmlShellCmd

Function type: xmlShellCmd
 int	xmlShellCmd			(xmlShellCtxtPtr ctxt, 
char * arg,
xmlNodePtr node,
xmlNodePtr node2)

This is a generic signature for the XML shell functions.

ctxt:a shell context
arg:a string argument
node:a first node
node2:a second node
Returns:an int, negative returns indicating errors.

Function: xmlShellDir

int	xmlShellDir			(xmlShellCtxtPtr ctxt, 
char * arg,
xmlNodePtr node,
xmlNodePtr node2)
-

Implements the XML shell function "dir" dumps informations about the node (namespace, attributes, content).

+

Implements the XML shell function "dir" dumps informations about the node (namespace, attributes, content).

ctxt:the shell context
arg:unused
node:a node
node2:unused
Returns:0

Function: xmlShellDu

int	xmlShellDu			(xmlShellCtxtPtr ctxt, 
char * arg,
xmlNodePtr tree,
xmlNodePtr node2)
-

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 "du" show the structure of the subtree under node @tree If @tree is null, the command works on the current node.

ctxt:the shell context
arg:unused
tree:a node defining a subtree
node2:unused
Returns:0 or -1 in case of error

Function: xmlShellList

int	xmlShellList			(xmlShellCtxtPtr ctxt, 
char * arg,
xmlNodePtr node,
xmlNodePtr node2)
-

Implements the XML shell function "ls" Does an Unix like listing of the given node (like a directory)

+

Implements the XML shell function "ls" Does an Unix like listing of the given node (like a directory)

ctxt:the shell context
arg:unused
node:a node
node2:unused
Returns:0

Function: xmlShellLoad

int	xmlShellLoad			(xmlShellCtxtPtr ctxt, 
char * filename,
xmlNodePtr node,
xmlNodePtr node2)
-

Implements the XML shell function "load" loads a new document specified by the filename

+

Implements the XML shell function "load" loads a new document specified by the filename

ctxt:the shell context
filename:the file name
node:unused
node2:unused
Returns:0 or -1 if loading failed

Function: xmlShellPrintNode

void	xmlShellPrintNode		(xmlNodePtr node)

Print node to the output FILE

node:a non-null node to print to the output FILE

Function: xmlShellPrintXPathError

void	xmlShellPrintXPathError		(int errorType, 
const char * arg)
@@ -104,14 +104,14 @@ int xmlShellCmd (xmlShellCtxtPt
errorType:valid xpath error id
arg:the argument that cause xpath to fail

Function: xmlShellPrintXPathResult

void	xmlShellPrintXPathResult	(xmlXPathObjectPtr list)

Prints result to the output FILE

list:a valid result generated by an xpath evaluation

Function: xmlShellPwd

int	xmlShellPwd			(xmlShellCtxtPtr ctxt, 
char * buffer,
xmlNodePtr node,
xmlNodePtr node2)
-

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.

+

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.

ctxt:the shell context
buffer:the output buffer
node:a node
node2:unused
Returns:0 or -1 in case of error

Function type: xmlShellReadlineFunc

Function type: xmlShellReadlineFunc
 char *	xmlShellReadlineFunc		(char * prompt)
 

This is a generic signature for the XML shell input function.

prompt:a string prompt
Returns:a string which will be freed by the Shell.

Function: xmlShellSave

int	xmlShellSave			(xmlShellCtxtPtr ctxt, 
char * filename,
xmlNodePtr node,
xmlNodePtr node2)
-

Implements the XML shell function "save" Write the current document to the filename, or it's original name

+

Implements the XML shell function "save" Write the current document to the filename, or it's original name

ctxt:the shell context
filename:the file name (optional)
node:unused
node2:unused
Returns:0 or -1 in case of error

Function: xmlShellValidate

int	xmlShellValidate		(xmlShellCtxtPtr ctxt, 
char * dtd,
xmlNodePtr node,
xmlNodePtr node2)
-

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 "validate" Validate the document, if a DTD path is provided, then the validation is done against the given DTD.

ctxt:the shell context
dtd:the DTD URI (optional)
node:unused
node2:unused
Returns:0 or -1 in case of error

Function: xmlShellWrite

int	xmlShellWrite			(xmlShellCtxtPtr ctxt, 
char * filename,
xmlNodePtr node,
xmlNodePtr node2)
-

Implements the XML shell function "write" Write the current node to the filename, it saves the serialization of the subtree under the @node specified

+

Implements the XML shell function "write" Write the current node to the filename, it saves the serialization of the subtree under the @node specified

ctxt:the shell context
filename:the file name
node:a node in the tree
node2:unused
Returns:0 or -1 in case of error

Daniel Veillard

diff --git a/doc/html/libxml-encoding.html b/doc/html/libxml-encoding.html index b02c7280..9ce2bd08 100644 --- a/doc/html/libxml-encoding.html +++ b/doc/html/libxml-encoding.html @@ -10,7 +10,7 @@ A:link, A:visited, A:active { text-decoration: underline } Module encoding from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module encoding from libxml2

API Menu
API Indexes
Related links

interface for the encoding conversion functions needed for XML basic encoding and iconv() support. Related specs are rfc2044 (UTF-8 and UTF-16) F. Yergeau Alis Technologies [ISO-10646] UTF-8 and UTF-16 in Annexes [ISO-8859-1] ISO Latin-1 characters codes. [UNICODE] The Unicode Consortium, "The Unicode Standard -- Worldwide Character Encoding -- Version 1.0", Addison- Wesley, Volume 1, 1991, Volume 2, 1992. UTF-8 is described in Unicode Technical Report #4. [US-ASCII] Coded Character Set--7-bit American Standard Code for Information Interchange, ANSI X3.4-1986.

Table of Contents

Enum xmlCharEncoding
+    Module encoding from libxml2
Action against software patentsGnome2 LogoW3C LogoRed Hat Logo
Made with Libxml2 Logo

Module encoding from libxml2

API Menu
API Indexes
Related links

interface for the encoding conversion functions needed for XML basic encoding and iconv() support. Related specs are rfc2044 (UTF-8 and UTF-16) F. Yergeau Alis Technologies [ISO-10646] UTF-8 and UTF-16 in Annexes [ISO-8859-1] ISO Latin-1 characters codes. [UNICODE] The Unicode Consortium, "The Unicode Standard -- Worldwide Character Encoding -- Version 1.0", Addison- Wesley, Volume 1, 1991, Volume 2, 1992. UTF-8 is described in Unicode Technical Report #4. [US-ASCII] Coded Character Set--7-bit American Standard Code for Information Interchange, ANSI X3.4-1986.

Table of Contents

Enum xmlCharEncoding
 
Structure xmlCharEncodingHandler
struct _xmlCharEncodingHandler
Typedef xmlCharEncodingHandler * xmlCharEncodingHandlerPtr
 
int	UTF8Toisolat1			(unsigned char * out, 
int * outlen,
const unsigned char * in,
int * inlen)
@@ -116,7 +116,7 @@ int xmlCharEncodingOutputFunc (unsigned char * out,
int * outlen,
name:a string describing the char encoding.
Returns:the handler or NULL if not found

Function: xmlGetCharEncodingHandler

xmlCharEncodingHandlerPtr	xmlGetCharEncodingHandler	(xmlCharEncoding enc)

Search in the registered set the handler able to read/write that encoding.

enc:an xmlCharEncoding value.
Returns:the handler or NULL if not found

Function: xmlGetCharEncodingName

const char *	xmlGetCharEncodingName	(xmlCharEncoding enc)
-

The "canonical" name for XML encoding. C.f. http://www.w3.org/TR/REC-xml#charencoding Section 4.3.3 Character Encoding in Entities

+

The "canonical" name for XML encoding. C.f. http://www.w3.org/TR/REC-xml#charencoding Section 4.3.3 Character Encoding in Entities

enc:the encoding
Returns:the canonical name for the given encoding

Function: xmlGetEncodingAlias

const char *	xmlGetEncodingAlias	(const char * alias)

Lookup an encoding name for the given alias.

alias:the alias name as parsed, in UTF-8 format (ASCII actually)
Returns:NULL if not found, otherwise the original name

Function: xmlGetUTF8Char

int	xmlGetUTF8Char			(const unsigned char * utf, 
int * len)
diff --git a/doc/html/libxml-nanoftp.html b/doc/html/libxml-nanoftp.html index 9208e50c..3843c9ab 100644 --- a/doc/html/libxml-nanoftp.html +++ b/doc/html/libxml-nanoftp.html @@ -44,7 +44,7 @@ void ftpDataCallback (void * userData,
const char * data,

A callback for the xmlNanoFTPGet command.

userData:the user provided context
data:the data received
len:its size in bytes

Function type: ftpListCallback

Function type: ftpListCallback
 void	ftpListCallback			(void * userData, 
const char * filename,
const char * attrib,
const char * owner,
const char * group,
unsigned long size,
int links,
int year,
const char * month,
int day,
int hour,
int minute) -

A callback for the xmlNanoFTPList command. Note that only one of year and day:minute are specified.

userData:user provided data for the callback
filename:the file name (including "->" when links are shown)
attrib:the attribute string
owner:the owner string
group:the group string
size:the file size
links:the link count
year:the year
month:the month
day:the day
hour:the hour
minute:the minute

+

A callback for the xmlNanoFTPList command. Note that only one of year and day:minute are specified.

userData:user provided data for the callback
filename:the file name (including "->" when links are shown)
attrib:the attribute string
owner:the owner string
group:the group string
size:the file size
links:the link count
year:the year
month:the month
day:the day
hour:the hour
minute:the minute

Function: xmlNanoFTPCheckResponse

int	xmlNanoFTPCheckResponse		(void * ctx)

Check if there is a response from the FTP server after a command.

ctx:an FTP context
Returns:the code number, or 0

Function: xmlNanoFTPCleanup

void	xmlNanoFTPCleanup		(void)
diff --git a/doc/html/libxml-parser.html b/doc/html/libxml-parser.html index 641a5b62..22d54ab5 100644 --- a/doc/html/libxml-parser.html +++ b/doc/html/libxml-parser.html @@ -424,7 +424,7 @@ void warningSAXFunc (void * ctx,
const char * msg,
...

Function: xmlInitParserCtxt

int	xmlInitParserCtxt		(xmlParserCtxtPtr ctxt)

Initialize a parser context

ctxt:an XML parser context
Returns:0 in case of success and -1 in case of error

Function: xmlKeepBlanksDefault

int	xmlKeepBlanksDefault		(int val)
-

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 xmlSAX2IgnorableWhitespace() 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.

+

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 xmlSAX2IgnorableWhitespace() 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.

val:int 0 or 1
Returns:the last value for 0 for no substitution, 1 for substitution.

Function: xmlLineNumbersDefault

int	xmlLineNumbersDefault		(int val)

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.

val:int 0 or 1
Returns:the last value for 0 for no substitution, 1 for substitution.

Function: xmlLoadExternalEntity

xmlParserInputPtr	xmlLoadExternalEntity	(const char * URL, 
const char * ID,
xmlParserCtxtPtr ctxt)
@@ -448,7 +448,7 @@ void warningSAXFunc (void * ctx,
const char * msg,
...
cur:a pointer to an array of xmlChar
Returns:the resulting document tree

Function: xmlParseDocument

int	xmlParseDocument		(xmlParserCtxtPtr ctxt)

parse an XML document (and build a tree if using the standard SAX interface). [1] document ::= prolog element Misc* [22] prolog ::= XMLDecl? Misc* (doctypedecl Misc*)?

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

Function: xmlParseEntity

xmlDocPtr	xmlParseEntity		(const char * filename)
-

parse an XML external entity out of context and build a tree. [78] extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk

+

parse an XML external entity out of context and build a tree. [78] extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk

filename:the filename
Returns:the resulting document tree

Function: xmlParseExtParsedEnt

int	xmlParseExtParsedEnt		(xmlParserCtxtPtr ctxt)

parse a general parsed entity An external general parsed entity is well-formed if it matches the production labeled extParsedEnt. [78] extParsedEnt ::= TextDecl? content

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

Function: xmlParseExternalEntity

int	xmlParseExternalEntity		(xmlDocPtr doc, 
xmlSAXHandlerPtr sax,
void * user_data,
int depth,
const xmlChar * URL,
const xmlChar * ID,
xmlNodePtr * lst)
@@ -493,7 +493,7 @@ void xmlParserInputDeallocate (xmlChar *
sax:the SAX handler block
ExternalID:a NAME* containing the External ID of the DTD
SystemID:a NAME* containing the URL to the DTD
Returns:the resulting xmlDtdPtr or NULL in case of error.

Function: xmlSAXParseDoc

xmlDocPtr	xmlSAXParseDoc		(xmlSAXHandlerPtr sax, 
xmlChar * cur,
int recovery)

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.

sax:the SAX handler block
cur:a pointer to an array of xmlChar
recovery:work in recovery mode, i.e. tries to read no Well Formed documents
Returns:the resulting document tree

Function: xmlSAXParseEntity

xmlDocPtr	xmlSAXParseEntity	(xmlSAXHandlerPtr sax, 
const char * filename)
-

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. [78] extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk

+

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. [78] extParsedEnt ::= TextDecl? content This correspond to a "Well Balanced" chunk

sax:the SAX handler block
filename:the filename
Returns:the resulting document tree

Function: xmlSAXParseFile

xmlDocPtr	xmlSAXParseFile		(xmlSAXHandlerPtr sax, 
const char * filename,
int recovery)

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.

sax:the SAX handler block
filename:the filename
recovery:work in recovery mode, i.e. tries to read no Well Formed documents
Returns:the resulting document tree

Function: xmlSAXParseFileWithData

xmlDocPtr	xmlSAXParseFileWithData	(xmlSAXHandlerPtr sax, 
const char * filename,
int recovery,
void * data)
diff --git a/doc/html/libxml-parserInternals.html b/doc/html/libxml-parserInternals.html index 2cfb2803..c722d96b 100644 --- a/doc/html/libxml-parserInternals.html +++ b/doc/html/libxml-parserInternals.html @@ -161,7 +161,7 @@ void xmlEntityReferenceFunc (
buffer:a pointer to a char array
size:the size of the array
Returns:the new parser context or NULL

Function: xmlCreateURLParserCtxt

xmlParserCtxtPtr	xmlCreateURLParserCtxt	(const char * filename, 
int options)

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

filename:the filename or URL
options:a combination of xmlParserOption(s)
Returns:the new parser context or NULL

Function: xmlCurrentChar

int	xmlCurrentChar			(xmlParserCtxtPtr ctxt, 
int * len)
-

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 "#xD#xA" 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.)

+

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 "#xD#xA" 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.)

ctxt:the XML parser context
len:pointer to the length of the char read
Returns:the current char value and its length

Function: xmlDecodeEntities

xmlChar *	xmlDecodeEntities	(xmlParserCtxtPtr ctxt, 
int len,
int what,
xmlChar end,
xmlChar end2,
xmlChar end3)

This function is deprecated, we now always process entities content through xmlStringDecodeEntities TODO: remove it in next major release. [67] Reference ::= EntityRef | CharRef [69] PEReference ::= '%' Name ';'

ctxt:the parser context
len:the len to decode (in bytes !), -1 for no size limit
what:combination of XML_SUBSTITUTE_REF and XML_SUBSTITUTE_PEREF
end:an end marker xmlChar, 0 if none
end2:an end marker xmlChar, 0 if none
end3:an end marker xmlChar, 0 if none
Returns:A newly allocated string with the substitution done. The caller must deallocate it !

Function type: xmlEntityReferenceFunc

Function type: xmlEntityReferenceFunc
@@ -192,9 +192,9 @@ void	xmlEntityReferenceFunc		(xmlEntityP
 
ctxt:an XML parser context
buffer:an memory buffer
Returns:the new input stream

Function: xmlNextChar

void	xmlNextChar			(xmlParserCtxtPtr ctxt)

Skip to the next char input char.

ctxt:the XML parser context

Function: xmlParseAttValue

xmlChar *	xmlParseAttValue	(xmlParserCtxtPtr ctxt)
-

parse a value for an attribute Note: the parser won't do substitution of entities here, this will be handled later in xmlStringGetNodeList [10] AttValue ::= '"' ([^<&"] | Reference)* '"' | "'" ([^<&'] | Reference)* "'" 3.3.3 Attribute-Value Normalization: Before the value of an attribute is passed to the application or checked for validity, the XML processor must normalize it as follows: - a character reference is processed by appending the referenced character to the attribute value - an entity reference is processed by recursively processing the replacement text of the entity - a whitespace character (#x20, #xD, #xA, #x9) is processed by appending #x20 to the normalized value, except that only a single #x20 is appended for a "#xD#xA" sequence that is part of an external parsed entity or the literal entity value of an internal parsed entity - other characters are processed by appending them to the normalized value If the declared value is not CDATA, then the XML processor must further process the normalized attribute value by discarding any leading and trailing space (#x20) characters, and by replacing sequences of space (#x20) characters by a single space (#x20) character. All attributes for which no declaration has been read should be treated by a non-validating parser as if declared CDATA.

+

parse a value for an attribute Note: the parser won't do substitution of entities here, this will be handled later in xmlStringGetNodeList [10] AttValue ::= '"' ([^<&"] | Reference)* '"' | "'" ([^<&'] | Reference)* "'" 3.3.3 Attribute-Value Normalization: Before the value of an attribute is passed to the application or checked for validity, the XML processor must normalize it as follows: - a character reference is processed by appending the referenced character to the attribute value - an entity reference is processed by recursively processing the replacement text of the entity - a whitespace character (#x20, #xD, #xA, #x9) is processed by appending #x20 to the normalized value, except that only a single #x20 is appended for a "#xD#xA" sequence that is part of an external parsed entity or the literal entity value of an internal parsed entity - other characters are processed by appending them to the normalized value If the declared value is not CDATA, then the XML processor must further process the normalized attribute value by discarding any leading and trailing space (#x20) characters, and by replacing sequences of space (#x20) characters by a single space (#x20) character. All attributes for which no declaration has been read should be treated by a non-validating parser as if declared CDATA.

ctxt:an XML parser context
Returns:the AttValue parsed or NULL. The value has to be freed by the caller.

Function: xmlParseAttribute

const xmlChar *	xmlParseAttribute	(xmlParserCtxtPtr ctxt, 
xmlChar ** value)
-

parse an attribute [41] Attribute ::= Name Eq AttValue [ WFC: No External Entity References ] Attribute values cannot contain direct or indirect entity references to external entities. [ WFC: No < in Attribute Values ] The replacement text of any entity referred to directly or indirectly in an attribute value (other than "&lt;") must not contain a <. [ VC: Attribute Value Type ] The attribute must have been declared; the value must be of the type declared for it. [25] Eq ::= S? '=' S? With namespace: [NS 11] Attribute ::= QName Eq AttValue Also the case QName == xmlns:??? is handled independently as a namespace definition.

+

parse an attribute [41] Attribute ::= Name Eq AttValue [ WFC: No External Entity References ] Attribute values cannot contain direct or indirect entity references to external entities. [ WFC: No < in Attribute Values ] The replacement text of any entity referred to directly or indirectly in an attribute value (other than "&lt;") must not contain a <. [ VC: Attribute Value Type ] The attribute must have been declared; the value must be of the type declared for it. [25] Eq ::= S? '=' S? With namespace: [NS 11] Attribute ::= QName Eq AttValue Also the case QName == xmlns:??? is handled independently as a namespace definition.

ctxt:an XML parser context
value:a xmlChar ** used to store the value of the attribute
Returns:the attribute name, and the value in *value.

Function: xmlParseAttributeListDecl

void	xmlParseAttributeListDecl	(xmlParserCtxtPtr ctxt)

: parse the Attribute list def for an element [52] AttlistDecl ::= '<!ATTLIST' S Name AttDef* S? '>' [53] AttDef ::= S Name S AttType S DefaultDecl

ctxt:an XML parser context

Function: xmlParseAttributeType

int	xmlParseAttributeType		(xmlParserCtxtPtr ctxt, 
xmlEnumerationPtr * tree)
@@ -202,11 +202,11 @@ void xmlEntityReferenceFunc (xmlEntityP
ctxt:an XML parser context
tree:the enumeration tree built while parsing
Returns:the attribute type

Function: xmlParseCDSect

void	xmlParseCDSect			(xmlParserCtxtPtr ctxt)

Parse escaped pure raw content. [18] CDSect ::= CDStart CData CDEnd [19] CDStart ::= '<![CDATA[' [20] Data ::= (Char* - (Char* ']]>' Char*)) [21] CDEnd ::= ']]>'

ctxt:an XML parser context

Function: xmlParseCharData

void	xmlParseCharData		(xmlParserCtxtPtr ctxt, 
int cdata)
-

parse a CharData section. if we are within a CDATA section ']]>' marks an end of section. The right angle bracket (>) may be represented using the string "&gt;", and must, for compatibility, be escaped using "&gt;" or a character reference when it appears in the string "]]>" in content, when that string is not marking the end of a CDATA section. [14] CharData ::= [^<&]* - ([^<&]* ']]>' [^<

+

parse a CharData section. if we are within a CDATA section ']]>' marks an end of section. The right angle bracket (>) may be represented using the string "&gt;", and must, for compatibility, be escaped using "&gt;" or a character reference when it appears in the string "]]>" in content, when that string is not marking the end of a CDATA section. [14] CharData ::= [^<&]* - ([^<&]* ']]>' [^<&]*)

ctxt:an XML parser context
cdata:int indicating whether we are within a CDATA section

Function: xmlParseCharRef

int	xmlParseCharRef			(xmlParserCtxtPtr ctxt)

parse Reference declarations [66] CharRef ::= '&#' [0-9]+ ';' | '&#x' [0-9a-fA-F]+ ';' [ WFC: Legal Character ] Characters referred to using character references must match the production for Char.

ctxt:an XML parser context
Returns:the value parsed (as an int), 0 in case of error

Function: xmlParseComment

void	xmlParseComment			(xmlParserCtxtPtr ctxt)
-

Skip an XML (SGML) comment <!-- .... --> The spec says that "For compatibility, the string "--" (double-hyphen) must not occur within comments. " [15] Comment ::= '<!--' ((Char - '-') | ('-' (Char - '-')))* '-->'

+

Skip an XML (SGML) comment <!-- .... --> The spec says that "For compatibility, the string "--" (double-hyphen) must not occur within comments. " [15] Comment ::= '<!--' ((Char - '-') | ('-' (Char - '-')))* '-->'

ctxt:an XML parser context

Function: xmlParseContent

void	xmlParseContent			(xmlParserCtxtPtr ctxt)

Parse a content: [43] content ::= (element | CharData | Reference | CDSect | PI | Comment)*

ctxt:an XML parser context

Function: xmlParseDefaultDecl

int	xmlParseDefaultDecl		(xmlParserCtxtPtr ctxt, 
xmlChar ** value)
@@ -226,15 +226,15 @@ void xmlEntityReferenceFunc (xmlEntityP
ctxt:an XML parser context
inputchk:the input used for the current entity, needed for boundary checks
Returns:the list of the xmlElementContentPtr describing the element choices

Function: xmlParseEncName

xmlChar *	xmlParseEncName		(xmlParserCtxtPtr ctxt)

parse the XML encoding name [81] EncName ::= [A-Za-z] ([A-Za-z0-9._] | '-')*

ctxt:an XML parser context
Returns:the encoding name value or NULL

Function: xmlParseEncodingDecl

const xmlChar *	xmlParseEncodingDecl	(xmlParserCtxtPtr ctxt)
-

parse the XML encoding declaration [80] EncodingDecl ::= S 'encoding' Eq ('"' EncName '"' | "'" EncName "'") this setups the conversion filters.

+

parse the XML encoding declaration [80] EncodingDecl ::= S 'encoding' Eq ('"' EncName '"' | "'" EncName "'") this setups the conversion filters.

ctxt:an XML parser context
Returns:the encoding value or NULL

Function: xmlParseEndTag

void	xmlParseEndTag			(xmlParserCtxtPtr ctxt)

parse an end of tag [42] ETag ::= '</' Name S? '>' With namespace [NS 9] ETag ::= '</' QName S? '>'

ctxt:an XML parser context

Function: xmlParseEntityDecl

void	xmlParseEntityDecl		(xmlParserCtxtPtr ctxt)

parse <!ENTITY declarations [70] EntityDecl ::= GEDecl | PEDecl [71] GEDecl ::= '<!ENTITY' S Name S EntityDef S? '>' [72] PEDecl ::= '<!ENTITY' S '%' S Name S PEDef S? '>' [73] EntityDef ::= EntityValue | (ExternalID NDataDecl?) [74] PEDef ::= EntityValue | ExternalID [76] NDataDecl ::= S 'NDATA' S Name [ VC: Notation Declared ] The Name must match the declared name of a notation.

ctxt:an XML parser context

Function: xmlParseEntityRef

xmlEntityPtr	xmlParseEntityRef	(xmlParserCtxtPtr ctxt)
-

parse ENTITY references declarations [68] EntityRef ::= '&' Name ';' [ WFC: Entity Declared ] In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with "standalone='yes'", the Name given in the entity reference must match that in an entity declaration, except that well-formed documents need not declare any of the following entities: amp, lt, gt, apos, quot. The declaration of a parameter entity must precede any reference to it. Similarly, the declaration of a general entity must precede any reference to it which appears in a default value in an attribute-list declaration. Note that if entities are declared in the external subset or in external parameter entities, a non-validating processor is not obligated to read and process their declarations; for such documents, the rule that an entity must be declared is a well-formedness constraint only if standalone='yes'. [ WFC: Parsed Entity ] An entity reference must not contain the name of an unparsed entity

+

parse ENTITY references declarations [68] EntityRef ::= '&' Name ';' [ WFC: Entity Declared ] In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with "standalone='yes'", the Name given in the entity reference must match that in an entity declaration, except that well-formed documents need not declare any of the following entities: amp, lt, gt, apos, quot. The declaration of a parameter entity must precede any reference to it. Similarly, the declaration of a general entity must precede any reference to it which appears in a default value in an attribute-list declaration. Note that if entities are declared in the external subset or in external parameter entities, a non-validating processor is not obligated to read and process their declarations; for such documents, the rule that an entity must be declared is a well-formedness constraint only if standalone='yes'. [ WFC: Parsed Entity ] An entity reference must not contain the name of an unparsed entity

ctxt:an XML parser context
Returns:the xmlEntityPtr if found, or NULL otherwise.

Function: xmlParseEntityValue

xmlChar *	xmlParseEntityValue	(xmlParserCtxtPtr ctxt, 
xmlChar ** orig)
-

parse a value for ENTITY declarations [9] EntityValue ::= '"' ([^%&"] | PEReference | Reference)* '"' | "'" ([^%&'] | PEReference | Reference)* "'"

+

parse a value for ENTITY declarations [9] EntityValue ::= '"' ([^%&"] | PEReference | Reference)* '"' | "'" ([^%&'] | PEReference | Reference)* "'"

ctxt:an XML parser context
orig:if non-NULL store a copy of the original entity value
Returns:the EntityValue parsed with reference substituted or NULL

Function: xmlParseEnumeratedType

int	xmlParseEnumeratedType		(xmlParserCtxtPtr ctxt, 
xmlEnumerationPtr * tree)

parse an Enumerated attribute type. [57] EnumeratedType ::= NotationType | Enumeration [58] NotationType ::= 'NOTATION' S '(' S? Name (S? '|' S? Name)* S? ')'

ctxt:an XML parser context
tree:the enumeration tree built while parsing
Returns:XML_ATTRIBUTE_ENUMERATION or XML_ATTRIBUTE_NOTATION

Function: xmlParseEnumerationType

xmlEnumerationPtr	xmlParseEnumerationType	(xmlParserCtxtPtr ctxt)
@@ -258,33 +258,33 @@ void xmlEntityReferenceFunc (xmlEntityP
ctxt:an XML parser context

Function: xmlParseNotationType

xmlEnumerationPtr	xmlParseNotationType	(xmlParserCtxtPtr ctxt)

parse an Notation attribute type. Note: the leading 'NOTATION' S part has already being parsed... [58] NotationType ::= 'NOTATION' S '(' S? Name (S? '|' S? Name)* S? ')' [ VC: Notation Attributes ] Values of this type must match one of the notation names included in the declaration; all notation names in the declaration must be declared.

ctxt:an XML parser context
Returns:the notation attribute tree built while parsing

Function: xmlParsePEReference

void	xmlParsePEReference		(xmlParserCtxtPtr ctxt)
-

parse PEReference declarations The entity content is handled directly by pushing it's content as a new input stream. [69] PEReference ::= '%' Name ';' [ WFC: No Recursion ] A parsed entity must not contain a recursive reference to itself, either directly or indirectly. [ WFC: Entity Declared ] In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with "standalone='yes'", ... ... The declaration of a parameter entity must precede any reference to it... [ VC: Entity Declared ] In a document with an external subset or external parameter entities with "standalone='no'", ... ... The declaration of a parameter entity must precede any reference to it... [ WFC: In DTD ] Parameter-entity references may only appear in the DTD. NOTE: misleading but this is handled.

+

parse PEReference declarations The entity content is handled directly by pushing it's content as a new input stream. [69] PEReference ::= '%' Name ';' [ WFC: No Recursion ] A parsed entity must not contain a recursive reference to itself, either directly or indirectly. [ WFC: Entity Declared ] In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with "standalone='yes'", ... ... The declaration of a parameter entity must precede any reference to it... [ VC: Entity Declared ] In a document with an external subset or external parameter entities with "standalone='no'", ... ... The declaration of a parameter entity must precede any reference to it... [ WFC: In DTD ] Parameter-entity references may only appear in the DTD. NOTE: misleading but this is handled.

ctxt:an XML parser context

Function: xmlParsePI

void	xmlParsePI			(xmlParserCtxtPtr ctxt)

parse an XML Processing Instruction. [16] PI ::= '<?' PITarget (S (Char* - (Char* '?>' Char*)))? '?>' The processing is transfered to SAX once parsed.

ctxt:an XML parser context

Function: xmlParsePITarget

const xmlChar *	xmlParsePITarget	(xmlParserCtxtPtr ctxt)

parse the name of a PI [17] PITarget ::= Name - (('X' | 'x') ('M' | 'm') ('L' | 'l'))

ctxt:an XML parser context
Returns:the PITarget name or NULL

Function: xmlParsePubidLiteral

xmlChar *	xmlParsePubidLiteral	(xmlParserCtxtPtr ctxt)
-

parse an XML public literal [12] PubidLiteral ::= '"' PubidChar* '"' | "'" (PubidChar - "'")* "'"

+

parse an XML public literal [12] PubidLiteral ::= '"' PubidChar* '"' | "'" (PubidChar - "'")* "'"

ctxt:an XML parser context
Returns:the PubidLiteral parsed or NULL.

Function: xmlParseQuotedString

xmlChar *	xmlParseQuotedString	(xmlParserCtxtPtr ctxt)

Parse and return a string between quotes or doublequotes TODO: Deprecated, to be removed at next drop of binary compatibility

ctxt:an XML parser context
Returns:the string parser or NULL.

Function: xmlParseReference

void	xmlParseReference		(xmlParserCtxtPtr ctxt)

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. [67] Reference ::= EntityRef | CharRef

ctxt:an XML parser context

Function: xmlParseSDDecl

int	xmlParseSDDecl			(xmlParserCtxtPtr ctxt)
-

parse the XML standalone declaration [32] SDDecl ::= S 'standalone' Eq (("'" ('yes' | 'no') "'") | ('"' ('yes' | 'no')'"')) [ VC: Standalone Document Declaration ] TODO The standalone document declaration must have the value "no" if any external markup declarations contain declarations of: - attributes with default values, if elements to which these attributes apply appear in the document without specifications of values for these attributes, or - entities (other than amp, lt, gt, apos, quot), if references to those entities appear in the document, or - attributes with values subject to normalization, where the attribute appears in the document with a value which will change as a result of normalization, or - element types with element content, if white space occurs directly within any instance of those types.

+

parse the XML standalone declaration [32] SDDecl ::= S 'standalone' Eq (("'" ('yes' | 'no') "'") | ('"' ('yes' | 'no')'"')) [ VC: Standalone Document Declaration ] TODO The standalone document declaration must have the value "no" if any external markup declarations contain declarations of: - attributes with default values, if elements to which these attributes apply appear in the document without specifications of values for these attributes, or - entities (other than amp, lt, gt, apos, quot), if references to those entities appear in the document, or - attributes with values subject to normalization, where the attribute appears in the document with a value which will change as a result of normalization, or - element types with element content, if white space occurs directly within any instance of those types.

ctxt:an XML parser context
Returns:1 if standalone, 0 otherwise

Function: xmlParseStartTag

const xmlChar *	xmlParseStartTag	(xmlParserCtxtPtr ctxt)

parse a start of tag either for rule element or EmptyElement. In both case we don't parse the tag closing chars. [40] STag ::= '<' Name (S Attribute)* S? '>' [ WFC: Unique Att Spec ] No attribute name may appear more than once in the same start-tag or empty-element tag. [44] EmptyElemTag ::= '<' Name (S Attribute)* S? '/>' [ WFC: Unique Att Spec ] No attribute name may appear more than once in the same start-tag or empty-element tag. With namespace: [NS 8] STag ::= '<' QName (S Attribute)* S? '>' [NS 10] EmptyElement ::= '<' QName (S Attribute)* S? '/>'

ctxt:an XML parser context
Returns:the element name parsed

Function: xmlParseSystemLiteral

xmlChar *	xmlParseSystemLiteral	(xmlParserCtxtPtr ctxt)
-

parse an XML Literal [11] SystemLiteral ::= ('"' [^"]* '"') | ("'" [^']* "'")

+

parse an XML Literal [11] SystemLiteral ::= ('"' [^"]* '"') | ("'" [^']* "'")

ctxt:an XML parser context
Returns:the SystemLiteral parsed or NULL

Function: xmlParseTextDecl

void	xmlParseTextDecl		(xmlParserCtxtPtr ctxt)

parse an XML declaration header for external entities [77] TextDecl ::= '<?xml' VersionInfo? EncodingDecl S? '?>' Question: Seems that EncodingDecl is mandatory ? Is that a typo ?

ctxt:an XML parser context

Function: xmlParseVersionInfo

xmlChar *	xmlParseVersionInfo	(xmlParserCtxtPtr ctxt)
-

parse the XML version. [24] VersionInfo ::= S 'version' Eq (' VersionNum ' | " VersionNum ") [25] Eq ::= S? '=' S?

-
ctxt:an XML parser context
Returns:the version string, e.g. "1.0"

Function: xmlParseVersionNum

xmlChar *	xmlParseVersionNum	(xmlParserCtxtPtr ctxt)
+

parse the XML version. [24] VersionInfo ::= S 'version' Eq (' VersionNum ' | " VersionNum ") [25] Eq ::= S? '=' S?

+
ctxt:an XML parser context
Returns:the version string, e.g. "1.0"

Function: xmlParseVersionNum

xmlChar *	xmlParseVersionNum	(xmlParserCtxtPtr ctxt)

parse the XML version value. [26] VersionNum ::= ([a-zA-Z0-9_.:] | '-')+

ctxt:an XML parser context
Returns:the string giving the XML version number, or NULL

Function: xmlParseXMLDecl

void	xmlParseXMLDecl			(xmlParserCtxtPtr ctxt)

parse an XML declaration header [23] XMLDecl ::= '<?xml' VersionInfo EncodingDecl? SDDecl? S? '?>'

ctxt:an XML parser context

Function: xmlParserHandlePEReference

void	xmlParserHandlePEReference	(xmlParserCtxtPtr ctxt)
-

[69] PEReference ::= '%' Name ';' [ WFC: No Recursion ] A parsed entity must not contain a recursive reference to itself, either directly or indirectly. [ WFC: Entity Declared ] In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with "standalone='yes'", ... ... The declaration of a parameter entity must precede any reference to it... [ VC: Entity Declared ] In a document with an external subset or external parameter entities with "standalone='no'", ... ... The declaration of a parameter entity must precede any reference to it... [ WFC: In DTD ] Parameter-entity references may only appear in the DTD. NOTE: misleading but this is handled. A PEReference may have been detected in the current input stream the handling is done accordingly to http://www.w3.org/TR/REC-xml#entproc i.e. - Included in literal in entity values - Included as Parameter Entity reference within DTDs

+

[69] PEReference ::= '%' Name ';' [ WFC: No Recursion ] A parsed entity must not contain a recursive reference to itself, either directly or indirectly. [ WFC: Entity Declared ] In a document without any DTD, a document with only an internal DTD subset which contains no parameter entity references, or a document with "standalone='yes'", ... ... The declaration of a parameter entity must precede any reference to it... [ VC: Entity Declared ] In a document with an external subset or external parameter entities with "standalone='no'", ... ... The declaration of a parameter entity must precede any reference to it... [ WFC: In DTD ] Parameter-entity references may only appear in the DTD. NOTE: misleading but this is handled. A PEReference may have been detected in the current input stream the handling is done accordingly to http://www.w3.org/TR/REC-xml#entproc i.e. - Included in literal in entity values - Included as Parameter Entity reference within DTDs

ctxt:the parser context

Function: xmlParserHandleReference

void	xmlParserHandleReference	(xmlParserCtxtPtr ctxt)

TODO: Remove, now deprecated ... the test is done directly in the content parsing routines. [67] Reference ::= EntityRef | CharRef [68] EntityRef ::= '&' Name ';' [ WFC: Entity Declared ] the Name given in the entity reference must match that in an entity declaration, except that well-formed documents need not declare any of the following entities: amp, lt, gt, apos, quot. [ WFC: Parsed Entity ] An entity reference must not contain the name of an unparsed entity [66] CharRef ::= '&#' [0-9]+ ';' | '&#x' [0-9a-fA-F]+ ';' A PEReference may have been detected in the current input stream the handling is done accordingly to http://www.w3.org/TR/REC-xml#entproc

ctxt:the parser context

Function: xmlParserInputShrink

void	xmlParserInputShrink		(xmlParserInputPtr in)
diff --git a/doc/html/libxml-tree.html b/doc/html/libxml-tree.html index e2ba46e6..2423352e 100644 --- a/doc/html/libxml-tree.html +++ b/doc/html/libxml-tree.html @@ -728,13 +728,13 @@ A:link, A:visited, A:active { text-decoration: underline }

Creation of a new node containing a CDATA block.

doc:the document
content:the CDATA block content content
len:the length of the block
Returns:a pointer to the new node object.

Function: xmlNewCharRef

xmlNodePtr	xmlNewCharRef		(xmlDocPtr doc, 
const xmlChar * name)

Creation of a new character reference node.

-
doc:the document
name:the char ref string, starting with # or "&# ... ;"
Returns:a pointer to the new node object.

Function: xmlNewChild

xmlNodePtr	xmlNewChild		(xmlNodePtr parent, 
xmlNsPtr ns,
const xmlChar * name,
const xmlChar * content)
-

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.

+
doc:the document
name:the char ref string, starting with # or "&# ... ;"
Returns:a pointer to the new node object.

Function: xmlNewChild

xmlNodePtr	xmlNewChild		(xmlNodePtr parent, 
xmlNsPtr ns,
const xmlChar * name,
const xmlChar * content)
+

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 allows entity references. XML special chars must be escaped first by using xmlEncodeEntitiesReentrant(), or xmlNewTextChild() should be used.

parent:the parent node
ns:a namespace if any
name:the name of the child
content:the XML content of the child if any.
Returns:a pointer to the new node object.

Function: xmlNewComment

xmlNodePtr	xmlNewComment		(const xmlChar * content)

Creation of a new node containing a comment.

content:the comment content
Returns:a pointer to the new node object.

Function: xmlNewDoc

xmlDocPtr	xmlNewDoc		(const xmlChar * version)

Creates a new XML document

-
version:xmlChar string giving the version of XML "1.0"
Returns:a new document

Function: xmlNewDocComment

xmlNodePtr	xmlNewDocComment	(xmlDocPtr doc, 
const xmlChar * content)
+
version:xmlChar string giving the version of XML "1.0"
Returns:a new document

Function: xmlNewDocComment

xmlNodePtr	xmlNewDocComment	(xmlDocPtr doc, 
const xmlChar * content)

Creation of a new node containing a comment within a document.

doc:the document
content:the comment content
Returns:a pointer to the new node object.

Function: xmlNewDocFragment

xmlNodePtr	xmlNewDocFragment	(xmlDocPtr doc)

Creation of a new Fragment node.

@@ -773,7 +773,7 @@ A:link, A:visited, A:active { text-decoration: underline }
doc:the document
name:the reference name, or the reference string with & and ;
Returns:a pointer to the new node object.

Function: xmlNewText

xmlNodePtr	xmlNewText		(const xmlChar * content)

Creation of a new text node.

content:the text content
Returns:a pointer to the new node object.

Function: xmlNewTextChild

xmlNodePtr	xmlNewTextChild		(xmlNodePtr parent, 
xmlNsPtr ns,
const xmlChar * name,
const xmlChar * content)
-

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. NOTE: Use xmlNewChild() if entity support for @content is needed.

+

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. NOTE: Use xmlNewChild() if @content will contain entities that need to be preserved. Use this function, xmlNewTextChild(), if you need to ensure that reserved XML chars that might appear in @content, such as the ampersand, greater-than or less-than signs, are automatically replaced by their XML escaped entity representations.

parent:the parent node
ns:a namespace if any
name:the name of the child
content:the text content of the child if any.
Returns:a pointer to the new node object.

Function: xmlNewTextLen

xmlNodePtr	xmlNewTextLen		(const xmlChar * content, 
int len)

Creation of a new text node with an extra parameter for the content's length

content:the text content
len:the text len.
Returns:a pointer to the new node object.

Function: xmlNodeAddContent

void	xmlNodeAddContent		(xmlNodePtr cur, 
const xmlChar * content)
@@ -794,7 +794,7 @@ A:link, A:visited, A:active { text-decoration: underline }

Searches the language of a node, i.e. the values of the xml:lang attribute or the one carried by the nearest ancestor.

cur:the node being checked
Returns:a pointer to the lang value, or NULL if not found It's up to the caller to free the memory with xmlFree().

Function: xmlNodeGetSpacePreserve

int	xmlNodeGetSpacePreserve		(xmlNodePtr cur)

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.

-
cur:the node being checked
Returns:-1 if xml:space is not inherited, 0 if "default", 1 if "preserve"

Function: xmlNodeIsText

int	xmlNodeIsText			(xmlNodePtr node)
+
cur:the node being checked
Returns:-1 if xml:space is not inherited, 0 if "default", 1 if "preserve"

Function: xmlNodeIsText

int	xmlNodeIsText			(xmlNodePtr node)

Is this node a Text node ?

node:the node
Returns:1 yes, 0 no

Function: xmlNodeListGetRawString

xmlChar *	xmlNodeListGetRawString	(xmlDocPtr doc, 
xmlNodePtr list,
int inLine)

Builds 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.

@@ -812,20 +812,20 @@ A:link, A:visited, A:active { text-decoration: underline }

Set (or reset) the name of a node.

cur:the node being changed
name:the new tag name

Function: xmlNodeSetSpacePreserve

void	xmlNodeSetSpacePreserve		(xmlNodePtr cur, 
int val)

Set (or reset) the space preserving behaviour of a node, i.e. the value of the xml:space attribute.

-
cur:the node being changed
val:the xml:space value ("0": default, 1: "preserve")

Function: xmlReconciliateNs

int	xmlReconciliateNs		(xmlDocPtr doc, 
xmlNodePtr tree)
+
cur:the node being changed
val:the xml:space value ("0": default, 1: "preserve")

Function: xmlReconciliateNs

int	xmlReconciliateNs		(xmlDocPtr doc, 
xmlNodePtr tree)

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.

doc:the document
tree:a node defining the subtree to reconciliate
Returns:the number of namespace declarations created or -1 in case of error.

Function: xmlRemoveProp

int	xmlRemoveProp			(xmlAttrPtr cur)

Unlink and free one attribute, all the content is freed too Note this doesn't work for namespace definition attributes

cur:an attribute
Returns:0 if success and -1 in case of error.

Function: xmlReplaceNode

xmlNodePtr	xmlReplaceNode		(xmlNodePtr old, 
xmlNodePtr cur)

Unlink the old node from its 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.

old:the old node
cur:the node
Returns:the @old node

Function: xmlSaveFile

int	xmlSaveFile			(const char * filename, 
xmlDocPtr cur)
-

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 to a file. Will use compression if compiled in and enabled. If @filename is "-" the stdout file is used.

filename:the filename (or URL)
cur:the document
Returns:the number of bytes written or -1 in case of failure.

Function: xmlSaveFileEnc

int	xmlSaveFileEnc			(const char * filename, 
xmlDocPtr cur,
const char * encoding)

Dump an XML document, converting it to the given encoding

filename:the filename (or URL)
cur:the document
encoding:the name of an encoding (or NULL)
Returns:the number of bytes written or -1 in case of failure.

Function: xmlSaveFileTo

int	xmlSaveFileTo			(xmlOutputBufferPtr buf, 
xmlDocPtr cur,
const char * encoding)

Dump an XML document to an I/O buffer.

buf:an output I/O buffer
cur:the document
encoding:the encoding if any assuming the I/O layer handles the trancoding
Returns:the number of bytes written or -1 in case of failure.

Function: xmlSaveFormatFile

int	xmlSaveFormatFile		(const char * filename, 
xmlDocPtr cur,
int format)
-

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. Note that @format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called

+

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. Note that @format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called

filename:the filename (or URL)
cur:the document
format:should formatting spaces been added
Returns:the number of bytes written or -1 in case of failure.

Function: xmlSaveFormatFileEnc

int	xmlSaveFormatFileEnc		(const char * filename, 
xmlDocPtr cur,
const char * encoding,
int format)

Dump an XML document to a file or an URL.

filename:the filename or URL to output
cur:the document being saved
encoding:the name of the encoding to use or NULL.
format:should formatting spaces be added.
Returns:the number of bytes written or -1 in case of error. Note that @format = 1 provide node indenting only if xmlIndentTreeOutput = 1 or xmlKeepBlanksDefault(0) was called

Function: xmlSaveFormatFileTo

int	xmlSaveFormatFileTo		(xmlOutputBufferPtr buf, 
xmlDocPtr cur,
const char * encoding,
int format)
diff --git a/doc/html/libxml-uri.html b/doc/html/libxml-uri.html index 386f0a31..4d8e40da 100644 --- a/doc/html/libxml-uri.html +++ b/doc/html/libxml-uri.html @@ -47,9 +47,9 @@ A:link, A:visited, A:active { text-decoration: underline }
uri:pointer to an xmlURI

Function: xmlNormalizeURIPath

int	xmlNormalizeURIPath		(char * path)

Applies the 5 normalization steps to a path string--that is, RFC 2396 Section 5.2, steps 6.c through 6.g. Normalization occurs directly on the string, no new allocation is done

path:pointer to the path string
Returns:0 or an error code

Function: xmlParseURI

xmlURIPtr	xmlParseURI		(const char * str)
-

Parse an URI URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]

+

Parse an URI URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]

str:the URI string to analyze
Returns:a newly build xmlURIPtr or NULL in case of error

Function: xmlParseURIReference

int	xmlParseURIReference		(xmlURIPtr uri, 
const char * str)
-

Parse an URI reference string and fills in the appropriate fields of the @uri structure URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]

+

Parse an URI reference string and fills in the appropriate fields of the @uri structure URI-reference = [ absoluteURI | relativeURI ] [ "#" fragment ]

uri:pointer to an URI structure
str:the string to analyze
Returns:0 or the error code

Function: xmlPrintURI

void	xmlPrintURI			(FILE * stream, 
xmlURIPtr uri)

Prints the URI in the stream @steam.

stream:a FILE* for the output
uri:pointer to an xmlURI

Function: xmlSaveUri

xmlChar *	xmlSaveUri		(xmlURIPtr uri)
diff --git a/doc/html/libxml-xinclude.html b/doc/html/libxml-xinclude.html index ff7b3676..4aec21f9 100644 --- a/doc/html/libxml-xinclude.html +++ b/doc/html/libxml-xinclude.html @@ -22,16 +22,16 @@ The content of this structure is not made public by the API.
int	xmlXIncludeProcessTreeFlags	(xmlNodePtr tree, 
int flags)
int	xmlXIncludeSetFlags		(xmlXIncludeCtxtPtr ctxt, 
int flags)

Description

-

Macro: XINCLUDE_FALLBACK

#define XINCLUDE_FALLBACK

Macro defining "fallback"

-

Macro: XINCLUDE_HREF

#define XINCLUDE_HREF

Macro defining "href"

-

Macro: XINCLUDE_NODE

#define XINCLUDE_NODE

Macro defining "include"

+

Macro: XINCLUDE_FALLBACK

#define XINCLUDE_FALLBACK

Macro defining "fallback"

+

Macro: XINCLUDE_HREF

#define XINCLUDE_HREF

Macro defining "href"

+

Macro: XINCLUDE_NODE

#define XINCLUDE_NODE

Macro defining "include"

Macro: XINCLUDE_NS

#define XINCLUDE_NS

Macro defining the Xinclude namespace: http://www.w3.org/2003/XInclude

Macro: XINCLUDE_OLD_NS

#define XINCLUDE_OLD_NS

Macro defining the draft Xinclude namespace: http://www.w3.org/2001/XInclude

-

Macro: XINCLUDE_PARSE

#define XINCLUDE_PARSE

Macro defining "parse"

-

Macro: XINCLUDE_PARSE_ENCODING

#define XINCLUDE_PARSE_ENCODING

Macro defining "encoding"

-

Macro: XINCLUDE_PARSE_TEXT

#define XINCLUDE_PARSE_TEXT

Macro defining "text"

-

Macro: XINCLUDE_PARSE_XML

#define XINCLUDE_PARSE_XML

Macro defining "xml"

-

Macro: XINCLUDE_PARSE_XPOINTER

#define XINCLUDE_PARSE_XPOINTER

Macro defining "xpointer"

+

Macro: XINCLUDE_PARSE

#define XINCLUDE_PARSE

Macro defining "parse"

+

Macro: XINCLUDE_PARSE_ENCODING

#define XINCLUDE_PARSE_ENCODING

Macro defining "encoding"

+

Macro: XINCLUDE_PARSE_TEXT

#define XINCLUDE_PARSE_TEXT

Macro defining "text"

+

Macro: XINCLUDE_PARSE_XML

#define XINCLUDE_PARSE_XML

Macro defining "xml"

+

Macro: XINCLUDE_PARSE_XPOINTER

#define XINCLUDE_PARSE_XPOINTER

Macro defining "xpointer"

Structure xmlXIncludeCtxt

Structure xmlXIncludeCtxt
struct _xmlXIncludeCtxt { The content of this structure is not made public by the API. }

Function: xmlXIncludeFreeContext

void	xmlXIncludeFreeContext		(xmlXIncludeCtxtPtr ctxt)
diff --git a/doc/html/libxml-xmlIO.html b/doc/html/libxml-xmlIO.html index ec556b97..01bf8829 100644 --- a/doc/html/libxml-xmlIO.html +++ b/doc/html/libxml-xmlIO.html @@ -143,7 +143,7 @@ int xmlInputReadCallback (void * context,
char * buffer,
fd:a file descriptor number
encoder:the encoding converter or NULL
Returns:the new parser output or NULL

Function: xmlOutputBufferCreateFile

xmlOutputBufferPtr	xmlOutputBufferCreateFile	(FILE * file, 
xmlCharEncodingHandlerPtr encoder)

Create a buffered output for the progressive saving to a FILE * buffered C I/O

file:a FILE*
encoder:the encoding converter or NULL
Returns:the new parser output or NULL

Function: xmlOutputBufferCreateFilename

xmlOutputBufferPtr	xmlOutputBufferCreateFilename	(const char * URI, 
xmlCharEncodingHandlerPtr encoder,
int compression)
-

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 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.

URI:a C string containing the URI or filename
encoder:the encoding converter or NULL
compression:the compression ration (0 none, 9 max).
Returns:the new output or NULL

Function: xmlOutputBufferCreateIO

xmlOutputBufferPtr	xmlOutputBufferCreateIO	(xmlOutputWriteCallback iowrite, 
xmlOutputCloseCallback ioclose,
void * ioctx,
xmlCharEncodingHandlerPtr encoder)

Create a buffered output for the progressive saving to an I/O handler

iowrite:an I/O write function
ioclose:an I/O close function
ioctx:an I/O handler
encoder:the charset encoding if known
Returns:the new parser output or NULL

Function: xmlOutputBufferFlush

int	xmlOutputBufferFlush		(xmlOutputBufferPtr out)
@@ -171,7 +171,7 @@ int xmlOutputWriteCallback (void * context,
const char * buffer,
fd:a file descriptor number
enc:the charset encoding if known
Returns:the new parser input or NULL

Function: xmlParserInputBufferCreateFile

xmlParserInputBufferPtr	xmlParserInputBufferCreateFile	(FILE * file, 
xmlCharEncoding enc)

Create a buffered parser input for the progressive parsing of a FILE * buffered C I/O

file:a FILE*
enc:the charset encoding if known
Returns:the new parser input or NULL

Function: xmlParserInputBufferCreateFilename

xmlParserInputBufferPtr	xmlParserInputBufferCreateFilename	(const char * URI, 
xmlCharEncoding enc)
-

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

+

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

URI:a C string containing the URI or filename
enc:the charset encoding if known
Returns:the new parser input or NULL

Function: xmlParserInputBufferCreateIO

xmlParserInputBufferPtr	xmlParserInputBufferCreateIO	(xmlInputReadCallback ioread, 
xmlInputCloseCallback ioclose,
void * ioctx,
xmlCharEncoding enc)

Create a buffered parser input for the progressive parsing for the input from an I/O handler

ioread:an I/O read function
ioclose:an I/O close function
ioctx:an I/O handler
enc:the charset encoding if known
Returns:the new parser input or NULL

Function: xmlParserInputBufferCreateMem

xmlParserInputBufferPtr	xmlParserInputBufferCreateMem	(const char * mem, 
int size,
xmlCharEncoding enc)
@@ -189,7 +189,7 @@ int xmlOutputWriteCallback (void * context,
const char * buffer, Function: xmlRegisterDefaultOutputCallbacks
void	xmlRegisterDefaultOutputCallbacks	(void)

Registers the default compiled-in I/O handlers.

Function: xmlRegisterHTTPPostCallbacks

void	xmlRegisterHTTPPostCallbacks	(void)
-

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.

+

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.

Function: xmlRegisterInputCallbacks

int	xmlRegisterInputCallbacks	(xmlInputMatchCallback matchFunc, 
xmlInputOpenCallback openFunc,
xmlInputReadCallback readFunc,
xmlInputCloseCallback closeFunc)

Register a new set of I/O callback for handling parser input.

matchFunc:the xmlInputMatchCallback
openFunc:the xmlInputOpenCallback
readFunc:the xmlInputReadCallback
closeFunc:the xmlInputCloseCallback
Returns:the registered handler number or -1 in case of error

Function: xmlRegisterOutputCallbacks

int	xmlRegisterOutputCallbacks	(xmlOutputMatchCallback matchFunc, 
xmlOutputOpenCallback openFunc,
xmlOutputWriteCallback writeFunc,
xmlOutputCloseCallback closeFunc)
diff --git a/doc/html/libxml-xmlreader.html b/doc/html/libxml-xmlreader.html index 17bd9957..936150d5 100644 --- a/doc/html/libxml-xmlreader.html +++ b/doc/html/libxml-xmlreader.html @@ -253,7 +253,7 @@ void xmlTextReaderErrorFunc (void * arg,
const char * msg,

This tells the XML Reader to preserve all nodes matched by the pattern. The caller must also use xmlTextReaderCurrentDoc() to keep an handle on the resulting document once parsing has finished

reader:the xmlTextReaderPtr used
pattern:an XPath subset pattern
namespaces:the prefix definitions, array of [URI, prefix] or NULL
Returns:a positive number in case of success and -1 in case of error

Function: xmlTextReaderQuoteChar

int	xmlTextReaderQuoteChar		(xmlTextReaderPtr reader)

The quotation mark character used to enclose the value of an attribute.

-
reader:the xmlTextReaderPtr used
Returns:" or ' and -1 in case of error

Function: xmlTextReaderRead

int	xmlTextReaderRead		(xmlTextReaderPtr reader)
+
reader:the xmlTextReaderPtr used
Returns:" or ' and -1 in case of error

Function: xmlTextReaderRead

int	xmlTextReaderRead		(xmlTextReaderPtr reader)

Moves the position of the current instance to the next node in the stream, exposing its properties.

reader:the xmlTextReaderPtr used
Returns:1 if the node was read successfully, 0 if there is no more nodes to read, or -1 in case of error

Function: xmlTextReaderReadAttributeValue

int	xmlTextReaderReadAttributeValue	(xmlTextReaderPtr reader)

Parses an attribute value into one or more Text and EntityReference nodes.

diff --git a/doc/html/libxml-xmlschemastypes.html b/doc/html/libxml-xmlschemastypes.html index 05ab90af..bbbdd902 100644 --- a/doc/html/libxml-xmlschemastypes.html +++ b/doc/html/libxml-xmlschemastypes.html @@ -34,7 +34,7 @@ A:link, A:visited, A:active { text-decoration: underline }

Cleanup the default XML Schemas type library

value:the value to free

Function: xmlSchemaGetPredefinedType

xmlSchemaTypePtr	xmlSchemaGetPredefinedType	(const xmlChar * name, 
const xmlChar * ns)

Lookup a type in the default XML Schemas type library

-
name:the type name
ns:the URI of the namespace usually "http://www.w3.org/2001/XMLSchema"
Returns:the type if found, NULL otherwise

Function: xmlSchemaInitTypes

void	xmlSchemaInitTypes		(void)
+
name:the type name
ns:the URI of the namespace usually "http://www.w3.org/2001/XMLSchema"
Returns:the type if found, NULL otherwise

Function: xmlSchemaInitTypes

void	xmlSchemaInitTypes		(void)

Initialize the default XML Schemas type library

Function: xmlSchemaNewFacet

xmlSchemaFacetPtr	xmlSchemaNewFacet	(void)

Allocate a new Facet structure.

diff --git a/doc/html/libxml-xmlversion.html b/doc/html/libxml-xmlversion.html index ec1fc950..95ee49c8 100644 --- a/doc/html/libxml-xmlversion.html +++ b/doc/html/libxml-xmlversion.html @@ -19,7 +19,7 @@ A:link, A:visited, A:active { text-decoration: underline }

Macro: LIBXML_CATALOG_ENABLED

#define LIBXML_CATALOG_ENABLED

Whether the Catalog support is configured in

Macro: LIBXML_DEBUG_ENABLED

#define LIBXML_DEBUG_ENABLED

Whether Debugging module is configured in

Macro: LIBXML_DOCB_ENABLED

#define LIBXML_DOCB_ENABLED

Whether the SGML Docbook support is configured in

-

Macro: LIBXML_DOTTED_VERSION

#define LIBXML_DOTTED_VERSION

the version string like "1.2.3"

+

Macro: LIBXML_DOTTED_VERSION

#define LIBXML_DOTTED_VERSION

the version string like "1.2.3"

Macro: LIBXML_FTP_ENABLED

#define LIBXML_FTP_ENABLED

Whether the FTP support is configured in

Macro: LIBXML_HTML_ENABLED

#define LIBXML_HTML_ENABLED

Whether the HTML support is configured in

Macro: LIBXML_HTTP_ENABLED

#define LIBXML_HTTP_ENABLED

Whether the HTTP support is configured in

@@ -39,7 +39,7 @@ A:link, A:visited, A:active { text-decoration: underline }

Macro: LIBXML_UNICODE_ENABLED

#define LIBXML_UNICODE_ENABLED

Whether the Unicode related interfaces are compiled in

Macro: LIBXML_VALID_ENABLED

#define LIBXML_VALID_ENABLED

Whether the DTD validation support is configured in

Macro: LIBXML_VERSION

#define LIBXML_VERSION

the version number: 1.2.3 value is 1002003

-

Macro: LIBXML_VERSION_STRING

#define LIBXML_VERSION_STRING

the version number string, 1.2.3 value is "1002003"

+

Macro: LIBXML_VERSION_STRING

#define LIBXML_VERSION_STRING

the version number string, 1.2.3 value is "1002003"

Macro: LIBXML_WRITER_ENABLED

#define LIBXML_WRITER_ENABLED

Whether the xmlWriter saving interface is configured in

Macro: LIBXML_XINCLUDE_ENABLED

#define LIBXML_XINCLUDE_ENABLED

Whether XInclude is configured in

Macro: LIBXML_XPATH_ENABLED

#define LIBXML_XPATH_ENABLED

Whether XPath is configured in

diff --git a/doc/html/libxml-xmlwriter.html b/doc/html/libxml-xmlwriter.html index d02e96d7..72bcf26f 100644 --- a/doc/html/libxml-xmlwriter.html +++ b/doc/html/libxml-xmlwriter.html @@ -138,7 +138,7 @@ The content of this structure is not made public by the API.

Start an xml DTD ATTLIST.

writer:the xmlTextWriterPtr
pe:TRUE if this is a parameter entity, FALSE if not
name:the name of the DTD ATTLIST
Returns:the bytes written (may be 0 because of buffering) or -1 in case of error

Function: xmlTextWriterStartDocument

int	xmlTextWriterStartDocument	(xmlTextWriterPtr writer, 
const char * version,
const char * encoding,
const char * standalone)

Start a new xml document

-
writer:the xmlTextWriterPtr
version:the xml version ("1.0") or NULL for default ("1.0")
encoding:the encoding or NULL for default
standalone:"yes" or "no" or NULL for default
Returns:the bytes written (may be 0 because of buffering) or -1 in case of error

Function: xmlTextWriterStartElement

int	xmlTextWriterStartElement	(xmlTextWriterPtr writer, 
const xmlChar * name)
+
writer:the xmlTextWriterPtr
version:the xml version ("1.0") or NULL for default ("1.0")
encoding:the encoding or NULL for default
standalone:"yes" or "no" or NULL for default
Returns:the bytes written (may be 0 because of buffering) or -1 in case of error

Function: xmlTextWriterStartElement

int	xmlTextWriterStartElement	(xmlTextWriterPtr writer, 
const xmlChar * name)

Start an xml element.

writer:the xmlTextWriterPtr
name:element name
Returns:the bytes written (may be 0 because of buffering) or -1 in case of error

Function: xmlTextWriterStartElementNS

int	xmlTextWriterStartElementNS	(xmlTextWriterPtr writer, 
const xmlChar * prefix,
const xmlChar * name,
const xmlChar * namespaceURI)

Start an xml element with namespace support.

diff --git a/doc/html/libxml-xpathInternals.html b/doc/html/libxml-xpathInternals.html index 6e97b1bc..e5b13f83 100644 --- a/doc/html/libxml-xpathInternals.html +++ b/doc/html/libxml-xpathInternals.html @@ -255,31 +255,31 @@ A:link, A:visited, A:active { text-decoration: underline }
val:the xmlChar * value
Returns:the newly created object.

Function: xmlXPathNewValueTree

xmlXPathObjectPtr	xmlXPathNewValueTree	(xmlNodePtr val)

Create a new xmlXPathObjectPtr of type Value Tree (XSLT) and initialize it with the tree root @val

val:the NodePtr value
Returns:the newly created object.

Function: xmlXPathNextAncestor

xmlNodePtr	xmlXPathNextAncestor	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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" 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

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextAncestorOrSelf

xmlNodePtr	xmlXPathNextAncestorOrSelf	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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 "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.

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextAttribute

xmlNodePtr	xmlXPathNextAttribute	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

Traversal function for the "attribute" direction TODO: support DTD inherited default attributes

+

Traversal function for the "attribute" direction TODO: support DTD inherited default attributes

ctxt:the XPath Parser context
cur:the current attribute in the traversal
Returns:the next element following that axis

Function: xmlXPathNextChild

xmlNodePtr	xmlXPathNextChild	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

Traversal function for the "child" direction The child axis contains the children of the context node in document order.

+

Traversal function for the "child" direction The child axis contains the children of the context node in document order.

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextDescendant

xmlNodePtr	xmlXPathNextDescendant	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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" 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.

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextDescendantOrSelf

xmlNodePtr	xmlXPathNextDescendantOrSelf	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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 "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

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextFollowing

xmlNodePtr	xmlXPathNextFollowing	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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" 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

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextFollowingSibling

xmlNodePtr	xmlXPathNextFollowingSibling	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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 "following-sibling" direction The following-sibling axis contains the following siblings of the context node in document order.

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextNamespace

xmlNodePtr	xmlXPathNextNamespace	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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 We keep the XML namespace node at the end of the list.

+

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 We keep the XML namespace node at the end of the list.

ctxt:the XPath Parser context
cur:the current attribute in the traversal
Returns:the next element following that axis

Function: xmlXPathNextParent

xmlNodePtr	xmlXPathNextParent	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

Traversal function for the "parent" direction The parent axis contains the parent of the context node, if there is one.

+

Traversal function for the "parent" direction The parent axis contains the parent of the context node, if there is one.

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextPreceding

xmlNodePtr	xmlXPathNextPreceding	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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" 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

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextPrecedingSibling

xmlNodePtr	xmlXPathNextPrecedingSibling	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

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 "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.

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNextSelf

xmlNodePtr	xmlXPathNextSelf	(xmlXPathParserContextPtr ctxt, 
xmlNodePtr cur)
-

Traversal function for the "self" direction The self axis contains just the context node itself

+

Traversal function for the "self" direction The self axis contains just the context node itself

ctxt:the XPath Parser context
cur:the current node in the traversal
Returns:the next element following that axis

Function: xmlXPathNodeLeading

xmlNodeSetPtr	xmlXPathNodeLeading	(xmlNodeSetPtr nodes, 
xmlNodePtr node)

Implements the EXSLT - Sets leading() function: node-set set:leading (node-set, node-set) @nodes is sorted by document order, then #exslSetsNodeLeadingSorted is called.

nodes:a node-set
node:a node
Returns:the nodes in @nodes that precede @node in document order, @nodes if @node is NULL or an empty node-set if @nodes doesn't contain @node

Function: xmlXPathNodeLeadingSorted

xmlNodeSetPtr	xmlXPathNodeLeadingSorted	(xmlNodeSetPtr nodes, 
xmlNodePtr node)
@@ -369,11 +369,11 @@ A:link, A:visited, A:active { text-decoration: underline }
ctxt:the XPath Parser context
nargs:the number of arguments

Function: xmlXPathSubValues

void	xmlXPathSubValues		(xmlXPathParserContextPtr ctxt)

Implement the subtraction operation on XPath objects: The numeric operators convert their operands to numbers as if by calling the number function.

ctxt:the XPath Parser context

Function: xmlXPathSubstringAfterFunction

void	xmlXPathSubstringAfterFunction	(xmlXPathParserContextPtr ctxt, 
int nargs)
-

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-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.

ctxt:the XPath Parser context
nargs:the number of arguments

Function: xmlXPathSubstringBeforeFunction

void	xmlXPathSubstringBeforeFunction	(xmlXPathParserContextPtr ctxt, 
int nargs)
-

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-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.

ctxt:the XPath Parser context
nargs:the number of arguments

Function: xmlXPathSubstringFunction

void	xmlXPathSubstringFunction	(xmlXPathParserContextPtr ctxt, 
int nargs)
-

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 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 ""

ctxt:the XPath Parser context
nargs:the number of arguments

Function: xmlXPathSumFunction

void	xmlXPathSumFunction		(xmlXPathParserContextPtr ctxt, 
int nargs)

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.

ctxt:the XPath Parser context
nargs:the number of arguments

Function: xmlXPathTrailing

xmlNodeSetPtr	xmlXPathTrailing	(xmlNodeSetPtr nodes1, 
xmlNodeSetPtr nodes2)
@@ -381,7 +381,7 @@ A:link, A:visited, A:active { text-decoration: underline }
nodes1:a node-set
nodes2:a node-set
Returns:the nodes in @nodes1 that follow the first node in @nodes2 in document order, @nodes1 if @nodes2 is NULL or empty or an empty node-set if @nodes1 doesn't contain @nodes2

Function: xmlXPathTrailingSorted

xmlNodeSetPtr	xmlXPathTrailingSorted	(xmlNodeSetPtr nodes1, 
xmlNodeSetPtr nodes2)

Implements the EXSLT - Sets trailing() function: node-set set:trailing (node-set, node-set)

nodes1:a node-set, sorted by document order
nodes2:a node-set, sorted by document order
Returns:the nodes in @nodes1 that follow the first node in @nodes2 in document order, @nodes1 if @nodes2 is NULL or empty or an empty node-set if @nodes1 doesn't contain @nodes2

Function: xmlXPathTranslateFunction

void	xmlXPathTranslateFunction	(xmlXPathParserContextPtr ctxt, 
int nargs)
-

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 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")

ctxt:the XPath Parser context
nargs:the number of arguments

Function: xmlXPathTrueFunction

void	xmlXPathTrueFunction		(xmlXPathParserContextPtr ctxt, 
int nargs)

Implement the true() XPath function boolean true()

ctxt:the XPath Parser context
nargs:the number of arguments

Function: xmlXPathValueFlipSign

void	xmlXPathValueFlipSign		(xmlXPathParserContextPtr ctxt)
diff --git a/doc/libxml2-api.xml b/doc/libxml2-api.xml index 33de4376..bfeea83b 100644 --- a/doc/libxml2-api.xml +++ b/doc/libxml2-api.xml @@ -9064,7 +9064,7 @@ actually an xmlCharEncoding'/> - 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 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 allows entity references. XML special chars must be escaped first by using xmlEncodeEntitiesReentrant(), or xmlNewTextChild() should be used. @@ -9259,7 +9259,7 @@ actually an xmlCharEncoding'/> - 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. NOTE: Use xmlNewChild() if entity support for @content is needed. + 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. NOTE: Use xmlNewChild() if @content will contain entities that need to be preserved. Use this function, xmlNewTextChild(), if you need to ensure that reserved XML chars that might appear in @content, such as the ampersand, greater-than or less-than signs, are automatically replaced by their XML escaped entity representations. diff --git a/doc/libxml2-refs.xml b/doc/libxml2-refs.xml index ef46d222..612c7b0c 100644 --- a/doc/libxml2-refs.xml +++ b/doc/libxml2-refs.xml @@ -5800,8 +5800,8 @@ - + @@ -5819,12 +5819,12 @@ - + @@ -5873,9 +5873,9 @@ + - @@ -5912,8 +5912,8 @@ - + @@ -5945,7 +5945,6 @@ - @@ -5957,6 +5956,7 @@ + @@ -6008,8 +6008,8 @@ - + @@ -6024,8 +6024,8 @@ - + @@ -6033,13 +6033,13 @@ + - @@ -6231,9 +6231,9 @@ - + @@ -6311,8 +6311,8 @@ - + @@ -15617,7 +15617,6 @@ - @@ -16301,7 +16300,6 @@ - @@ -16339,6 +16337,7 @@ + @@ -16395,6 +16394,9 @@ + + + @@ -16457,6 +16459,7 @@ + @@ -16635,6 +16638,7 @@ + @@ -16941,7 +16945,6 @@ - @@ -17793,6 +17796,7 @@ + @@ -18989,6 +18993,9 @@ + + + @@ -19120,6 +19127,7 @@ + @@ -19937,6 +19945,9 @@ + + + @@ -21031,6 +21042,9 @@ + + + @@ -21593,6 +21607,9 @@ + + + @@ -21806,9 +21823,9 @@ - + @@ -21823,9 +21840,7 @@ - - @@ -22872,6 +22887,7 @@ + @@ -23673,6 +23689,7 @@ + @@ -23711,6 +23728,9 @@ + + + @@ -23756,6 +23776,7 @@ + @@ -24312,6 +24333,9 @@ + + + @@ -25004,6 +25028,7 @@ + @@ -25177,6 +25202,7 @@ + @@ -26621,6 +26647,7 @@ + @@ -27092,6 +27119,7 @@ +