diff --git a/ChangeLog b/ChangeLog index 50790ba4..c13cc190 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Tue Dec 28 17:42:41 CET 1999 Daniel Veillard + + * doc/* : rebuilt the documentation + Tue Dec 28 18:44:22 CET 1999 Daniel Veillard * parser.[ch] parserInternals.h: Push parser for XML, diff --git a/doc/html/book1.html b/doc/html/book1.html index b3e5fdd4..1e53fbc0 100644 --- a/doc/html/book1.html +++ b/doc/html/book1.html @@ -63,7 +63,7 @@ CLASS="ABSTRACT" >

This manual documents the interfaces of the libglade +>This manual documents the interfaces of the libxml library and has some short notes to help get you up to speed with using the library.

Name

Synopsis

Description

Details

#define     XML_INTERNAL_GENERAL_ENTITY
#define XML_INTERNAL_GENERAL_ENTITY 1

#define     XML_EXTERNAL_GENERAL_PARSED_ENTITY
#define XML_EXTERNAL_GENERAL_PARSED_ENTITY 2

#define     XML_EXTERNAL_GENERAL_UNPARSED_ENTITY
#define XML_EXTERNAL_GENERAL_UNPARSED_ENTITY 3

#define     XML_INTERNAL_PARAMETER_ENTITY
#define XML_INTERNAL_PARAMETER_ENTITY 4

#define     XML_EXTERNAL_PARAMETER_ENTITY
#define XML_EXTERNAL_PARAMETER_ENTITY 5

#define     XML_INTERNAL_PREDEFINED_ENTITY
#define XML_INTERNAL_PREDEFINED_ENTITY 6

xmlEntityPtr

typedef xmlEntity *xmlEntityPtr;


#define     XML_MIN_ENTITIES_TABLE
#define XML_MIN_ENTITIES_TABLE 32

xmlEntitiesTablePtr

typedef xmlEntitiesTable *xmlEntitiesTablePtr;


  the document  the entity name  the entity type XML_xxx_yyy_ENTITY  the entity external ID if available  the entity system ID if available  the entity content


  the document  the entity name  the entity type XML_xxx_yyy_ENTITY  the entity external ID if available  the entity system ID if available  the entity content


  the entity name NULL if not, othervise the entity


  the document referencing the entity  the entity name A pointer to the entity structure or NULL if not found.


  the document referencing the entity  the entity name A pointer to the entity structure or NULL if not found.


  the document referencing the entity  the entity name A pointer to the entity structure or NULL if not found.


  the document containing the string  A string to convert to XML. A newly allocated string with the substitution done.


  the document containing the string  A string to convert to XML. A newly allocated string with the substitution done.


 the xmlEntitiesTablePtr just created or NULL in case of error.


  An entity table the new xmlEntitiesTablePtr or NULL in case of error.


  An entity table


  An XML buffer.  An entity table


Name

Synopsis

Description

Details

htmlParserCtxt

typedef xmlParserCtxt htmlParserCtxt;


htmlParserCtxtPtr

typedef xmlParserCtxtPtr htmlParserCtxtPtr;


htmlParserNodeInfo

typedef xmlParserNodeInfo htmlParserNodeInfo;


htmlSAXHandler

typedef xmlSAXHandler htmlSAXHandler;


htmlSAXHandlerPtr

typedef xmlSAXHandlerPtr htmlSAXHandlerPtr;


htmlParserInput

typedef xmlParserInput htmlParserInput;


htmlParserInputPtr

typedef xmlParserInputPtr htmlParserInputPtr;


htmlDocPtr

typedef xmlDocPtr htmlDocPtr;


htmlNodePtr

typedef xmlNodePtr htmlNodePtr;


  The tag name the related htmlElemDescPtr or NULL if not found.


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


  the HTML document  the HTML element 1 if autoclosed, 0 otherwise


  the HTML document  The tag name  the HTML element 1 if autoclose, 0 otherwise


  an HTML parser context  location to store the entity name the associated htmlEntityDescPtr if found, or NULL otherwise, +if non-NULL *str will have to be freed by the caller.


  an HTML parser context the value parsed (as an int)


  an HTML parser context


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


  a pointer to an array of xmlChar  a free form C string describing the HTML document encoding, or NULL the resulting document tree


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


  the filename  a free form C string describing the HTML document encoding, or NULL the resulting document tree

Name

Synopsis

Description

Details

#define     HTML_TEXT_NODE
#define HTML_TEXT_NODE XML_TEXT_NODE

#define     HTML_ENTITY_REF_NODE
#define HTML_ENTITY_REF_NODE XML_ENTITY_REF_NODE

#define     HTML_COMMENT_NODE
#define HTML_COMMENT_NODE XML_COMMENT_NODE

  the document  OUT: the memory pointer  OUT: the memory lenght


  the FILE*  the document


  the filename  the document  the number of byte written or -1 in case of failure.

Name

Synopsis

Description

Details

  The URL to load  the filename where the content should be saved  if available the Content-Type information will be +returned at that location -1 in case of failure, 0 incase of success. The contentType, +if provided must be freed by the caller


  The URL to load  the HTTP method to use  the input string if any  the Content-Type information IN and OUT  the extra headers


  The URL to load  if available the Content-Type information will be +returned at that location


  the HTTP context the HTTP return code for the request.


  the HTTP context  a buffer  the buffer length the number of byte read. 0 is an indication of an end of connection. +-1 indicates a parameter error.


  the HTTP context  the filename where the content should be saved -1 in case of failure, 0 incase of success.


  the HTTP context

xmlChar *SystemID); void xmlDefaultSAXHandlerInit (void); +void htmlDefaultSAXHandlerInit (void); +void xmlInitParserCtxt (xmlParserCtxtPtr ctxt); void xmlFreeParserCtxt (xmlParserCtxtPtr ctxt); +void xmlSetupParserForBuffer (xmlChar *buffer, const char *filename); -void xmlDefaultSAXHandlerInit (void); -void htmlDefaultSAXHandlerInit (void); +xmlParserCtxtPtr xmlCreateDocParserCtxt (xmlChar *cur); +xmlParserCtxtPtr xmlCreatePushParserCtxt (xmlSAXHandlerPtr sax, + void *user_data, + const char *chunk, + int size, + const char *filename); +int xmlParseChunk (xmlParserCtxtPtr ctxt, + const char *chunk, + int size, + int terminate); const xmlParserNodeInfo

Description

Details

#define     XML_DEFAULT_VERSION
#define XML_DEFAULT_VERSION "1.0"


xmlParserInputPtr

typedef xmlParserInput *xmlParserInputPtr;



xmlParserNodeInfo

typedef _xmlParserNodeInfo xmlParserNodeInfo;


xmlParserNodeInfoSeq

typedef _xmlParserNodeInfoSeq xmlParserNodeInfoSeq;


xmlParserNodeInfoSeqPtr

typedef xmlParserNodeInfoSeq *xmlParserNodeInfoSeqPtr;


typedef enum {
-    XML_PARSER_EOF = 0,
-    XML_PARSER_PROLOG,
-    XML_PARSER_CONTENT,
-    XML_PARSER_ENTITY_DECL,
-    XML_PARSER_ENTITY_VALUE,
-    XML_PARSER_ATTRIBUTE_VALUE,
-    XML_PARSER_DTD,
-    XML_PARSER_EPILOG,
-    XML_PARSER_COMMENT,
-    XML_PARSER_CDATA_SECTION 
+    XML_PARSER_EOF = -1,	/* nothing is to be parsed */
+    XML_PARSER_START = 0,	/* nothing has been parsed */
+    XML_PARSER_MISC,		/* Misc* before int subset */
+    XML_PARSER_PI,		/* Whithin a processing instruction */
+    XML_PARSER_DTD,		/* within some DTD content */
+    XML_PARSER_PROLOG,		/* Misc* after internal subset */
+    XML_PARSER_COMMENT,		/* within a comment */
+    XML_PARSER_START_TAG,	/* within a start tag */
+    XML_PARSER_CONTENT,		/* within the content */
+    XML_PARSER_CDATA_SECTION,	/* within a CDATA section */
+    XML_PARSER_END_TAG,		/* within a closing tag */
+    XML_PARSER_ENTITY_DECL,	/* within an entity declaration */
+    XML_PARSER_ENTITY_VALUE,	/* within an entity value in a decl */
+    XML_PARSER_ATTRIBUTE_VALUE,	/* within an attribute value */
+    XML_PARSER_EPILOG 		/* the Misc* after the last end tag */
 } xmlParserInputState;

xmlParserCtxt

typedef _xmlParserCtxt xmlParserCtxt;


xmlParserCtxtPtr

typedef xmlParserCtxt *xmlParserCtxtPtr;


xmlSAXLocator

typedef _xmlSAXLocator xmlSAXLocator;


xmlSAXLocatorPtr

typedef xmlSAXLocator *xmlSAXLocatorPtr;





























xmlSAXHandlerPtr

typedef xmlSAXHandler *xmlSAXHandlerPtr;








  an XML parser input  an indicative size for the lookahead the number of xmlChars read, or -1 in case of error, 0 indicate the +end of this entity


  an XML parser input  an indicative size for the lookahead the number of xmlChars read, or -1 in case of error, 0 indicate the +end of this entity


  the input xmlChar * a new xmlChar * or NULL


  the input xmlChar *  the len of cur a new xmlChar * or NULL


  the xmlChar * array (haystack)  the index of the first char (zero based)  the length of the substring the xmlChar * for the first occurence or NULL.


  the xmlChar * array  the xmlChar to search the xmlChar * for the first occurence or NULL.


  the xmlChar * array (haystack)  the xmlChar to search (needle) the xmlChar * for the first occurence or NULL.


  the first xmlChar *  the second xmlChar * the integer result of the comparison


  the first xmlChar *  the second xmlChar *  the max comparison length the integer result of the comparison


  the xmlChar * array the number of xmlChar contained in the ARRAY.


  the original xmlChar * array  the xmlChar * array added a new xmlChar * containing the concatenated string.


  the original xmlChar * array  the xmlChar * array added  the length of add a new xmlChar * containing the concatenated string.


  a pointer to an array of xmlChar the resulting document tree


  an pointer to a char array  the size of the array the resulting document tree


  the filename the resulting document tree


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


  a pointer to an array of xmlChar the resulting document tree


  an pointer to a char array  the size of the array the resulting document tree


  the filename the resulting document tree


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


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


  a SAX handler  The user data returned on SAX callbacks  a file name 0 in case of success or a error number otherwise


  a SAX handler  The user data returned on SAX callbacks  an in-memory XML document input  the length of the XML document in bytes 0 in case of success or a error number otherwise


  the SAX handler block  an pointer to a char array  the size of the array  work in recovery mode, i.e. tries to read not Well Formed +documents the resulting document tree


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


  a NAME* containing the External ID of the DTD  a NAME* containing the URL to the DTD the resulting xmlDtdPtr or NULL in case of error.


  the SAX handler block  a NAME* containing the External ID of the DTD  a NAME* containing the URL to the DTD the resulting xmlDtdPtr or NULL in case of error.


xmlDefaultSAXHandlerInit ()

void        xmlDefaultSAXHandlerInit        (void);

Initialize the default SAX handler


htmlDefaultSAXHandlerInit ()

void        htmlDefaultSAXHandlerInit       (void);

Initialize the default SAX handler


  an HTML parser context


  an XML parser context


xmlFreeParserCtxt ()

void        xmlFreeParserCtxt               (xmlParserCtxtPtr ctxt);

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

ctxt : an XML parser context


  an XML parser context  a xmlChar * buffer  a file name


xmlDefaultSAXHandlerInit ()

xmlCreateDocParserCtxt ()

void        xmlDefaultSAXHandlerInit        (void);
xmlParserCtxtPtr xmlCreateDocParserCtxt (xmlChar *cur);

Initialize the default SAX handler

Create a parser context for an XML in-memory document.

cur : a pointer to an array of xmlChar
Returns :the new parser context or NULL


htmlDefaultSAXHandlerInit ()

xmlCreatePushParserCtxt ()

void        htmlDefaultSAXHandlerInit       (void);
xmlParserCtxtPtr xmlCreatePushParserCtxt (xmlSAXHandlerPtr sax, + void *user_data, + const char *chunk, + int size, + const char *filename);

Initialize the default SAX handler

Create a parser context for using the XML parser in push mode +To allow content encoding detection, size should be >= 4 +The value of filename is used for fetching external entities +and error/warning reports.

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
Returns :the new parser context or NULL


xmlParseChunk ()

int         xmlParseChunk                   (xmlParserCtxtPtr ctxt,
+                                             const char *chunk,
+                                             int size,
+                                             int terminate);

Parse a Chunk of memory

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


  an XML parser context  an XML node within the tree an xmlParserNodeInfo block pointer or NULL


  a node info sequence pointer


  a node info sequence pointer


  a node info sequence pointer  an XML node pointer a long indicating the position of the record


  an XML parser context  a node info sequence pointer




Name

Synopsis

xmlParserCtxtPtr xmlCreateDocParserCtxt ( (char *buffer, int size); void xmlFreeParserCtxt ( (xmlParserCtxtPtr ctxt, - xmlChar *tagname); +> ctxt); void xmlParseCDSect

Description

Details

#define     XML_MAX_NAMELEN
#define XML_MAX_NAMELEN 1000



#define     SKIPCHARVAL(p)
#define SKIPCHARVAL(p) (p)++;














  the filename the new parser context or NULL


  an pointer to a char array  the size of the array the new parser context or NULL



 the xmlParserCtxtPtr or NULL


  the parser context  the encoding value (number)


  an XML parser context  an XML entity pointer.


  an XML parser context  an Entity pointer the new input stream or NULL


  an XML parser context  an XML parser input fragment (entity, XML fragment ...).


  an XML parser context the current xmlChar in the parser context


  an xmlParserInputPtr


  an XML parser context  the filename to use as entity the new input stream or NULL in case of error


  an XML parser context  a xmlChar **  the local part, and prefix is updated +to get the Prefix if any.


  an XML parser context the namespace name or NULL


  an XML parser context  a xmlChar **  the local part, and prefix is updated +to get the Prefix if any.


  an XML parser context the namespace name


  an XML parser context the string parser or NULL.


  an XML parser context


  an XML parser context the Name parsed or NULL


  an XML parser context the Name parsed or NULL


  an XML parser context the Nmtoken parsed or NULL


  an XML parser context  if non-NULL store a copy of the original entity value the EntityValue parsed with reference substitued or NULL


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


  an XML parser context the SystemLiteral parsed or NULL


  an XML parser context the PubidLiteral parsed or NULL.


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


  an XML parser context  a xmlChar** receiving PubidLiteral  indicate whether we should restrict parsing to only +production [75], see NOTE below the function returns SystemLiteral and in the second +case publicID receives PubidLiteral, is strict is off +it is possible to return NULL and have publicID set.


  an XML parser context


  an XML parser context the PITarget name or NULL


  an XML parser context


  an XML parser context


  an XML parser context


  an XML parser context  Receive a possible fixed default value for the attribute  XML_ATTRIBUTE_NONE, XML_ATTRIBUTE_REQUIRED, XML_ATTRIBUTE_IMPLIED +or XML_ATTRIBUTE_FIXED.


  an XML parser context  the notation attribute tree built while parsing


  an XML parser context  the enumeration attribute tree built while parsing


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


[ VC: IDREF ] Values of type IDREF must match the Name production, and values -of type IDREFS must match Names; TODO each IDREF Name must match the value +of type IDREFS must match Names; each IDREF Name must match the value of an ID attribute on some element in the XML document; i.e. IDREF values must match the value of some ID attribute.

[ VC: Entity Name ] Values of type ENTITY must match the Name production, values -of type ENTITIES must match Names; TODO each Entity Name must match the +of type ENTITIES must match Names; each Entity Name must match the name of an unparsed entity declared in the DTD.

[ VC: Name Token ] @@ -5049,7 +5051,7 @@ CLASS="PARAMETER" WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" ->  an XML parser context  the enumeration tree built while parsing the attribute type


  an XML parser context


  an XML parser context  the list of the xmlElementContentPtr describing the element choices


  an XML parser context  the tree of xmlElementContentPtr describing the element +hierarchy.


  an XML parser context  the name of the element being defined.  the Element Content pointer will be stored here if any  the type of element content XML_ELEMENT_TYPE_xxx


  an XML parser context the type of the element, or -1 in case of error


  an XML parser context


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


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


  an XML parser context


  an XML parser context


  an XML parser context


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


  an XML parser context

void xmlParseEndTag (xmlParserCtxtPtr ctxt, - xmlChar *tagname); ctxt); tagname :  an XML parser context


  an XML parser context


  an XML parser context


  an XML parser context


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


  an XML parser context the version string, e.g. "1.0"


  an XML parser context the encoding name value or NULL


  an XML parser context the encoding value or NULL


  an XML parser context 1 if standalone, 0 otherwise


  an XML parser context


  an XML parser context


  an XML parser context  the external identifier  the system identifier (or URL)


#define     XML_SUBSTITUTE_NONE
#define XML_SUBSTITUTE_NONE 0

#define     XML_SUBSTITUTE_REF
#define XML_SUBSTITUTE_REF 1

#define     XML_SUBSTITUTE_PEREF
#define XML_SUBSTITUTE_PEREF 2

#define     XML_SUBSTITUTE_BOTH
#define XML_SUBSTITUTE_BOTH 3

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





Name

Synopsis

xmlDocPtr cur); +void xmlElemDump (FILE *f, + xmlDocPtr cur, + xmlNodePtr elem); int xmlSaveFile

Description

Details



#define     CHAR
#define CHAR xmlChar

#define     BAD_CAST
#define BAD_CAST (xmlChar *)

xmlNotationPtr

typedef xmlNotation *xmlNotationPtr;




xmlEnumerationPtr

typedef xmlEnumeration *xmlEnumerationPtr;


xmlAttributePtr

typedef xmlAttribute *xmlAttributePtr;




xmlElementContentPtr

typedef xmlElementContent *xmlElementContentPtr;



xmlElementPtr

typedef xmlElement *xmlElementPtr;



xmlNsPtr

typedef xmlNs *xmlNsPtr;


xmlDtdPtr

typedef xmlDtd *xmlDtdPtr;


xmlAttrPtr

typedef xmlAttr *xmlAttrPtr;


xmlIDPtr

typedef xmlID *xmlIDPtr;


xmlRefPtr

typedef xmlRef *xmlRefPtr;



xmlBuffer

typedef _xmlBuffer xmlBuffer;


xmlBufferPtr

typedef xmlBuffer *xmlBufferPtr;


xmlNode

typedef _xmlNode xmlNode;


xmlNodePtr

typedef _xmlNode *xmlNodePtr;


xmlDoc

typedef _xmlDoc xmlDoc;


xmlDocPtr

typedef xmlDoc *xmlDocPtr;






 the new structure.


  initial size of buffer the new structure.


  the buffer to free


  the file output  the buffer to dump the number of xmlChar written


  the buffer to dump  the xmlChar string  the number of xmlChar to add


  the buffer to dump  the xmlChar string


  the buffer to dump  the C char string


  the buffer to dump  the number of xmlChar to remove the number of xmlChar removed, or -1 in case of failure.


  the buffer


  the buffer to resize the internal content




  the buffer  the length of data in the internal content


  the document pointer  the DTD name  the external ID  the system ID a pointer to the new DTD structure


  the document pointer  the DTD name  the external ID  the system ID a pointer to the new DTD structure


  the DTD structure to free up


  the document carrying the namespace  the URI associated  the prefix for the namespace returns a new namespace pointer


  the element carrying the namespace  the URI associated  the prefix for the namespace returns a new namespace pointer


  the namespace pointer


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


  pointer to the document +@:


  the document  the name of the attribute  the value of the attribute a pointer to the attribute


  the holding node  the name of the attribute  the value of the attribute a pointer to the attribute


  the holding node  the namespace  the name of the attribute  the value of the attribute a pointer to the attribute


  the first property in the list


  the first property in the list


  the element where the attribute will be grafted  the attribute  a new xmlAttrPtr, or NULL in case of error.


  the element where the attributes will be grafted  the first attribute  a new xmlAttrPtr, or NULL in case of error.


  the dtd  a new xmlDtdPtr, or NULL in case of error.


  the document  if 1 do a recursive copy.  a new xmlDocPtr, or NULL in case of error.


  the document  namespace if any  the node name  the XML text content if any a pointer to the new node object.


  the document  namespace if any  the node name  the text content if any a pointer to the new node object.


  namespace if any  the node name a pointer to the new node object.


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


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


  the document  the text content a pointer to the new node object.


  the text content a pointer to the new node object.


  the processing instruction name  the PI content a pointer to the new node object.


  the document  the text content  the text len. a pointer to the new node object.


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


  the document  the comment content a pointer to the new node object.


  the comment content a pointer to the new node object.


  the document  the CData block content content  the length of the block a pointer to the new node object.


  the document  the reference name, or the reference string with & and ; a pointer to the new node object.


  the node  if 1 do a recursive copy.  a new xmlNodePtr, or NULL in case of error.


  the first node in the list.  a new xmlNodePtr, or NULL in case of error.


  the document the xmlNodePtr for the root or NULL


  the parent node the last child or NULL if none.


  the node 1 yes, 0 no


  the document  the new document root element the old root element if any was found


  the node being changed  the new tag name


  the parent node  the child node the child or NULL in case of error.


  the old node  the node the old node


  the child node  the new node the new element or NULL in case of error.


  the child node  the new node the new element or NULL in case of error.


  the child node  the new node the new element or NULL in case of error.


  the node


  the first text node  the second text node being merged the first text node augmented


  the node  the content  content lenght


  the first node in the list


  the node


  the document  the current node  the namespace string the namespace pointer or NULL.


  the document  the current node  the namespace value the namespace pointer or NULL.


  the document  the current node an NULL terminated array of all the xmlNsPtr found +that need to be freed by the caller or NULL if no +namespace if defined


  a node in the document  a namespace pointer


  the namespace  a new xmlNsPtr, or NULL in case of error.


  the first namespace  a new xmlNsPtr, or NULL in case of error.


  the node  the attribute name  the attribute value the attribute pointer.


  the node  the attribute name the attribute value or NULL if not found. +It's up to the caller to free the memory.


  the node  the attribute name  the URI of the namespace the attribute value or NULL if not found. +It's up to the caller to free the memory.


  the document  the value of the attribute a pointer to the first child


  the document  the value of the text  the length of the string value a pointer to the first child


  the document  a Node list  should we replace entity contents or show their external form a pointer to the string copy, the calller must free it.


  the node being modified  the new value of the content


  the node being modified  the new value of the content  the size of content


  the node being modified  extra content


  the node being modified  extra content  the size of content


  the node being read a new xmlChar * or NULL if no content is available. +It's up to the caller to free the memory.


  the node being checked a pointer to the lang value, or NULL if not found +It's up to the caller to free the memory.


  the node being changed  the langage description


  the document the node pertains to  the node being checked a pointer to the base URL, or NULL if not found +It's up to the caller to free the memory.




  the XML buffer  the string to add


  the XML buffer output  the string to add


  the XML buffer output  the string to add



xmlElemDump ()

void        xmlElemDump                     (FILE *f,
+                                             xmlDocPtr cur,
+                                             xmlNodePtr elem);

Dump an XML/HTML node, recursive behaviour,children are printed too.

the current node
f : 
elem : 

  the filename  the document  the number of file written or -1 in case of failure.


  the document 0 (uncompressed) to 9 (max compression)


  the document  the compression ratio


 0 (uncompressed) to 9 (max compression)


  the compression ratio

Name

Synopsis

Description

Details



#define     XML_MIN_NOTATION_TABLE
#define XML_MIN_NOTATION_TABLE 32

xmlNotationTablePtr

typedef xmlNotationTable *xmlNotationTablePtr;


#define     XML_MIN_ELEMENT_TABLE
#define XML_MIN_ELEMENT_TABLE 32

xmlElementTablePtr

typedef xmlElementTable *xmlElementTablePtr;


#define     XML_MIN_ATTRIBUTE_TABLE
#define XML_MIN_ATTRIBUTE_TABLE 32

xmlAttributeTablePtr

typedef xmlAttributeTable *xmlAttributeTablePtr;


#define     XML_MIN_ID_TABLE
#define XML_MIN_ID_TABLE 32

xmlIDTablePtr

typedef xmlIDTable *xmlIDTablePtr;


#define     XML_MIN_REF_TABLE
#define XML_MIN_REF_TABLE 32

xmlRefTablePtr

typedef xmlRefTable *xmlRefTablePtr;


  the validation context  pointer to the DTD  the entity name  the public identifier or NULL  the system identifier or NULL NULL if not, othervise the entity


  A notation table the new xmlNotationTablePtr or NULL in case of error.


  An notation table


  the XML buffer output  A notation table


  the subelement name or NULL  the type of element content decl NULL if not, othervise the new element content structure


  An element content pointer. the new xmlElementContentPtr or NULL in case of error.


  the element content tree to free


  the validation context  pointer to the DTD  the entity name  the element type  the element content tree or NULL NULL if not, othervise the entity


  An element table the new xmlElementTablePtr or NULL in case of error.


  An element table


  the XML buffer output  An element table


  the enumeration name or NULL the xmlEnumerationPtr just created or NULL in case +of error.


  the tree to free.


  the tree to copy. the xmlEnumerationPtr just created or NULL in case +of error.


  the validation context  pointer to the DTD  the element name  the attribute name  the attribute type  the attribute default type  the attribute default value  if it's an enumeration, the associated list NULL if not, othervise the entity


  An attribute table the new xmlAttributeTablePtr or NULL in case of error.


  An attribute table


  the XML buffer output  An attribute table


  the validation context  pointer to the document  the value name  the attribute holding the ID NULL if not, othervise the new xmlIDPtr



  An id table


  pointer to the document  the ID value NULL if not found, otherwise the xmlAttrPtr defining the ID


  the document  the element carrying the attribute  the attribute 0 or 1 depending on the lookup result


  the validation context  pointer to the document  the value name  the attribute holding the Ref NULL if not, othervise the new xmlRefPtr



  An ref table


  the document  the element carrying the attribute  the attribute 0 or 1 depending on the lookup result


  the validation context  a document instance 1 if valid or 0 otherwise


  the validation context  a document instance  an element definition 1 if valid or 0 otherwise


  the validation context  a document instance  an attribute definition 1 if valid or 0 otherwise


  an attribute type  an attribute value 1 if valid or 0 otherwise


  the validation context  a document instance  a notation definition 1 if valid or 0 otherwise


  the validation context  a document instance  a dtd instance 1 if valid or 0 otherwise


  the validation context  a document instance 1 if valid or 0 otherwise


  the validation context  a document instance  an element instance 1 if valid or 0 otherwise


  the validation context  a document instance  an element instance 1 if valid or 0 otherwise


  the validation context  a document instance  an element instance  an attribute instance  the attribute value (without entities processing) 1 if valid or 0 otherwise


  the validation context  a document instance 1 if valid or 0 otherwise


  the validation context  the document  the notation name to check 1 if valid or 0 otherwise


  the document  the element name 0 if no, 1 if yes, and -1 if no element description is available


  a pointer to the DtD to search  the element name  the attribute name the xmlAttributePtr if found or NULL


  a pointer to the DtD to search  the notation name the xmlNotationPtr if found or NULL


  a pointer to the DtD to search  the element name the xmlElementPtr if found or NULL


  an element to insert after  an element to insert next  an array to store the list of child names  the size of the array the number of element in the list, or -1 in case of error. If +the function returns the value max the caller is invited to grow the +receiving array and retry.


  an element content tree  an array to store the list of child names  a pointer to the number of element in the list  the size of the array the number of element in the list, or -1 in case of error.

Name

Synopsis

Description

Details


  an XML parser context  the message to display/transmit  extra parameters for the message display


  an XML parser context  the message to display/transmit  extra parameters for the message display


  an XML parser context  the message to display/transmit  extra parameters for the message display


  an XML parser context  the message to display/transmit  extra parameters for the message display


  an xmlParserInputPtr input


  an xmlParserInputPtr input

Name

Synopsis

FILE *fp); +void xmlMemShow (FILE *fp, + int nr); #define DEBUG_MEMORY_LOCATION

Description

Details

#define     NO_DEBUG_MEMORY
#define NO_DEBUG_MEMORY




 a pointer to the new string or NULL if allocation error occured.


 0 on success


 an int representing the amount of memory allocated.



  a FILE descriptor used as the output file, if NULL, the result is +written to the file .memorylist


xmlMemShow ()

void        xmlMemShow                      (FILE *fp,
+                                             int nr);

show a show display of the memory allocated, and dump +the nr last allocated areas which were not freed

fp : a FILE descriptor used as the output file
nr : number of entries to dump


#define     DEBUG_MEMORY_LOCATION
#define DEBUG_MEMORY_LOCATION

#define     DEBUG_MEMORY
#define DEBUG_MEMORY

#define     MEM_LIST
#define MEM_LIST /* keep a list of all the allocated memory blocks */

  an int specifying the size in byte to allocate.  the file name or NULL + file: the line number

  the initial memory block pointer  an int specifying the size in byte to allocate. the line number the file name or NULL

the line number the file name or NULL a pointer to the new string or NULL if allocation error occured.

Name

Synopsis

xmlXPathContextPtr ctxt); ctxt); +xmlNodeSetPtr xmlXPathNodeSetCreate (xmlNodePtr val); +void xmlXPathFreeNodeSetList (xmlXPathObjectPtr obj); +void xmlXPathFreeNodeSet (xmlNodeSetPtr obj);

Description

Details

#define     XPATH_UNDEFINED
#define XPATH_UNDEFINED 0

#define     XPATH_NODESET
#define XPATH_NODESET 1

#define     XPATH_BOOLEAN
#define XPATH_BOOLEAN 2

#define     XPATH_NUMBER
#define XPATH_NUMBER 3

#define     XPATH_STRING
#define XPATH_STRING 4

#define     XPATH_USERS
#define XPATH_USERS 5





  the XML document the xmlXPathContext just allocated.


  the context to free


  the XPath expression  the XPath context the xmlXPathObjectPtr resulting from the eveluation or NULL. +the caller has to free the object.



xmlXPathNodeSetCreate ()

xmlNodeSetPtr xmlXPathNodeSetCreate         (xmlNodePtr val);

Create a new xmlNodeSetPtr of type double and of value val

val : an initial xmlNodePtr, or NULL
Returns :the newly created object.


xmlXPathFreeNodeSetList ()

void        xmlXPathFreeNodeSetList         (xmlXPathObjectPtr obj);

Free up the xmlXPathObjectPtr obj but don't deallocate the objects in +the list contrary to xmlXPathFreeObject().

obj : an existing NodeSetList object


xmlXPathFreeNodeSet ()

void        xmlXPathFreeNodeSet             (xmlNodeSetPtr obj);

Free the NodeSet compound (not the actual nodes !).

obj : the xmlNodeSetPtr to free

- - - + + + + + + + @@ -242,6 +246,7 @@ + @@ -380,6 +385,9 @@ + + + @@ -390,6 +398,7 @@ + @@ -505,8 +514,13 @@ + + + + + @@ -517,6 +531,7 @@ +