tree

Gnome XML Library Reference Manual
<<< Previous Page	Home	Up	Next Page >>>

Details

enum xmlElementType

typedef enum {
    XML_ELEMENT_NODE=		1,
    XML_ATTRIBUTE_NODE=		2,
    XML_TEXT_NODE=		3,
    XML_CDATA_SECTION_NODE=	4,
    XML_ENTITY_REF_NODE=	5,
    XML_ENTITY_NODE=		6,
    XML_PI_NODE=		7,
    XML_COMMENT_NODE=		8,
    XML_DOCUMENT_NODE=		9,
    XML_DOCUMENT_TYPE_NODE=	10,
    XML_DOCUMENT_FRAG_NODE=	11,
    XML_NOTATION_NODE=		12,
    XML_HTML_DOCUMENT_NODE=	13,
    XML_DTD_NODE=		14,
    XML_ELEMENT_DECL=		15,
    XML_ATTRIBUTE_DECL=		16,
    XML_ENTITY_DECL=		17
} xmlElementType;

xmlChar

typedef unsigned char xmlChar;

CHAR

#define CHAR xmlChar

BAD_CAST

#define BAD_CAST (xmlChar *)

struct xmlNotation

struct xmlNotation {
    const xmlChar               *name;	/* Notation name */
    const xmlChar               *PublicID;	/* Public identifier, if any */
    const xmlChar               *SystemID;	/* System identifier, if any */
};

xmlNotationPtr

typedef xmlNotation *xmlNotationPtr;

enum xmlAttributeType

typedef enum {
    XML_ATTRIBUTE_CDATA = 1,
    XML_ATTRIBUTE_ID,
    XML_ATTRIBUTE_IDREF	,
    XML_ATTRIBUTE_IDREFS,
    XML_ATTRIBUTE_ENTITY,
    XML_ATTRIBUTE_ENTITIES,
    XML_ATTRIBUTE_NMTOKEN,
    XML_ATTRIBUTE_NMTOKENS,
    XML_ATTRIBUTE_ENUMERATION,
    XML_ATTRIBUTE_NOTATION
} xmlAttributeType;

enum xmlAttributeDefault

typedef enum {
    XML_ATTRIBUTE_NONE = 1,
    XML_ATTRIBUTE_REQUIRED,
    XML_ATTRIBUTE_IMPLIED,
    XML_ATTRIBUTE_FIXED
} xmlAttributeDefault;

struct xmlEnumeration

struct xmlEnumeration {
    struct _xmlEnumeration    *next;	/* next one */
    const xmlChar            *name;	/* Enumeration name */
};

xmlEnumerationPtr

typedef xmlEnumeration *xmlEnumerationPtr;

struct xmlAttribute

struct xmlAttribute {
#ifndef XML_WITHOUT_CORBA
    void           *_private;	        /* for Corba, must be first ! */
#endif
    xmlElementType          type;       /* XML_ATTRIBUTE_DECL, must be second ! */
    const xmlChar          *name;	/* Attribute name */
    struct _xmlNode    *children;	/* NULL */
    struct _xmlNode        *last;	/* NULL */
    struct _xmlDtd       *parent;	/* -> DTD */
    struct _xmlNode        *next;	/* next sibling link  */
    struct _xmlNode        *prev;	/* previous sibling link  */
    struct _xmlDoc          *doc;       /* the containing document */

    struct _xmlAttribute  *nexth;	/* next in hash table */
    xmlAttributeType       atype;	/* The attribute type */
    xmlAttributeDefault      def;	/* the default */
    const xmlChar  *defaultValue;	/* or the default value */
    xmlEnumerationPtr       tree;       /* or the enumeration tree if any */
    const xmlChar        *prefix;	/* the namespace prefix if any */
    const xmlChar          *elem;	/* Element holding the attribute */
};

xmlAttributePtr

typedef xmlAttribute *xmlAttributePtr;

enum xmlElementContentType

typedef enum {
    XML_ELEMENT_CONTENT_PCDATA = 1,
    XML_ELEMENT_CONTENT_ELEMENT,
    XML_ELEMENT_CONTENT_SEQ,
    XML_ELEMENT_CONTENT_OR
} xmlElementContentType;

enum xmlElementContentOccur

typedef enum {
    XML_ELEMENT_CONTENT_ONCE = 1,
    XML_ELEMENT_CONTENT_OPT,
    XML_ELEMENT_CONTENT_MULT,
    XML_ELEMENT_CONTENT_PLUS
} xmlElementContentOccur;

struct xmlElementContent

struct xmlElementContent {
    xmlElementContentType     type;	/* PCDATA, ELEMENT, SEQ or OR */
    xmlElementContentOccur    ocur;	/* ONCE, OPT, MULT or PLUS */
    const xmlChar            *name;	/* Element name */
    struct _xmlElementContent *c1;	/* first child */
    struct _xmlElementContent *c2;	/* second child */
};

xmlElementContentPtr

typedef xmlElementContent *xmlElementContentPtr;

enum xmlElementTypeVal

typedef enum {
    XML_ELEMENT_TYPE_EMPTY = 1,
    XML_ELEMENT_TYPE_ANY,
    XML_ELEMENT_TYPE_MIXED,
    XML_ELEMENT_TYPE_ELEMENT
} xmlElementTypeVal;

struct xmlElement

struct xmlElement {
#ifndef XML_WITHOUT_CORBA
    void           *_private;	        /* for Corba, must be first ! */
#endif
    xmlElementType          type;       /* XML_ELEMENT_DECL, must be second ! */
    const xmlChar          *name;	/* Element name */
    struct _xmlNode    *children;	/* NULL */
    struct _xmlNode        *last;	/* NULL */
    struct _xmlDtd       *parent;	/* -> DTD */
    struct _xmlNode        *next;	/* next sibling link  */
    struct _xmlNode        *prev;	/* previous sibling link  */
    struct _xmlDoc          *doc;       /* the containing document */

    xmlElementTypeVal      etype;	/* The type */
    xmlElementContentPtr content;	/* the allowed element content */
    xmlAttributePtr   attributes;	/* List of the declared attributes */
    const xmlChar        *prefix;	/* the namespace prefix if any */
};

xmlElementPtr

typedef xmlElement *xmlElementPtr;

enum xmlNsType

typedef enum {
    XML_GLOBAL_NAMESPACE = 1,	/* old style global namespace */
    XML_LOCAL_NAMESPACE		/* new style local scoping */
} xmlNsType;

struct xmlNs

struct xmlNs {
    struct _xmlNs  *next;	/* next Ns link for this node  */
    xmlNsType      type;	/* global or local */
    const xmlChar *href;	/* URL for the namespace */
    const xmlChar *prefix;	/* prefix for the namespace */
};

xmlNsPtr

typedef xmlNs *xmlNsPtr;

struct xmlDtd

struct xmlDtd {
#ifndef XML_WITHOUT_CORBA
    void           *_private;	/* for Corba, must be first ! */
#endif
    xmlElementType  type;       /* XML_DTD_NODE, must be second ! */
    const xmlChar *name;	/* Name of the DTD */
    struct _xmlNode *children;	/* the value of the property link */
    struct _xmlNode *last;	/* last child link */
    struct _xmlDoc  *parent;	/* child->parent link */
    struct _xmlNode *next;	/* next sibling link  */
    struct _xmlNode *prev;	/* previous sibling link  */
    struct _xmlDoc  *doc;	/* the containing document */

    /* End of common part */
    void          *notations;   /* Hash table for notations if any */
    void          *elements;    /* Hash table for elements if any */
    void          *attributes;  /* Hash table for attributes if any */
    void          *entities;    /* Hash table for entities if any */
    const xmlChar *ExternalID;	/* External identifier for PUBLIC DTD */
    const xmlChar *SystemID;	/* URI for a SYSTEM or PUBLIC DTD */
};

xmlDtdPtr

typedef xmlDtd *xmlDtdPtr;

struct xmlAttr

struct xmlAttr {
#ifndef XML_WITHOUT_CORBA
    void           *_private;	/* for Corba, must be first ! */
#endif
    xmlElementType   type;      /* XML_ATTRIBUTE_NODE, must be second ! */
    const xmlChar   *name;      /* the name of the property */
    struct _xmlNode *children;	/* the value of the property */
    struct _xmlNode *last;	/* NULL */
    struct _xmlNode *parent;	/* child->parent link */
    struct _xmlAttr *next;	/* next sibling link  */
    struct _xmlAttr *prev;	/* previous sibling link  */
    struct _xmlDoc  *doc;	/* the containing document */
    xmlNs           *ns;        /* pointer to the associated namespace */
    xmlAttributeType atype;     /* the attribute type if validating */
};

xmlAttrPtr

typedef xmlAttr *xmlAttrPtr;

struct xmlID

struct xmlID {
    struct _xmlID    *next;	/* next ID */
    const xmlChar    *value;	/* The ID name */
    xmlAttrPtr        attr;	/* The attribut holding it */
};

xmlIDPtr

typedef xmlID *xmlIDPtr;

struct xmlRef

struct xmlRef {
    struct _xmlRef    *next;	/* next Ref */
    const xmlChar     *value;	/* The Ref name */
    xmlAttrPtr        attr;	/* The attribut holding it */
};

xmlRefPtr

typedef xmlRef *xmlRefPtr;

enum xmlBufferAllocationScheme

typedef enum {
    XML_BUFFER_ALLOC_DOUBLEIT,
    XML_BUFFER_ALLOC_EXACT
} xmlBufferAllocationScheme;

struct xmlBuffer

struct xmlBuffer {
    xmlChar *content;		/* The buffer content UTF8 */
    unsigned int use;		/* The buffer size used */
    unsigned int size;		/* The buffer size */
    xmlBufferAllocationScheme alloc; /* The realloc method */
};

xmlBufferPtr

typedef xmlBuffer *xmlBufferPtr;

struct xmlNode

struct xmlNode {
#ifndef XML_WITHOUT_CORBA
    void           *_private;	/* for Corba, must be first ! */
#endif
    xmlElementType   type;	/* type number, must be second ! */
    const xmlChar   *name;      /* the name of the node, or the entity */
    struct _xmlNode *children;	/* parent->childs link */
    struct _xmlNode *last;	/* last child link */
    struct _xmlNode *parent;	/* child->parent link */
    struct _xmlNode *next;	/* next sibling link  */
    struct _xmlNode *prev;	/* previous sibling link  */
    struct _xmlDoc  *doc;	/* the containing document */
    xmlNs           *ns;        /* pointer to the associated namespace */
#ifndef XML_USE_BUFFER_CONTENT    
    xmlChar         *content;   /* the content */
#else
    xmlBufferPtr     content;   /* the content in a buffer */
#endif

    /* End of common part */
    struct _xmlAttr *properties;/* properties list */
    xmlNs           *nsDef;     /* namespace definitions on this node */
};

xmlNodePtr

typedef xmlNode *xmlNodePtr;

struct xmlDoc

struct xmlDoc {
#ifndef XML_WITHOUT_CORBA
    void           *_private;	/* for Corba, must be first ! */
#endif
    xmlElementType  type;       /* XML_DOCUMENT_NODE, must be second ! */
    char           *name;	/* name/filename/URI of the document */
    struct _xmlNode *children;	/* the document tree */
    struct _xmlNode *last;	/* last child link */
    struct _xmlNode *parent;	/* child->parent link */
    struct _xmlNode *next;	/* next sibling link  */
    struct _xmlNode *prev;	/* previous sibling link  */
    struct _xmlDoc  *doc;	/* autoreference to itself */

    /* End of common part */
    int             compression;/* level of zlib compression */
    int             standalone; /* standalone document (no external refs) */
    struct _xmlDtd  *intSubset;	/* the document internal subset */
    struct _xmlDtd  *extSubset;	/* the document external subset */
    struct _xmlNs   *oldNs;	/* Global namespace, the old way */
    const xmlChar  *version;	/* the XML version string */
    const xmlChar  *encoding;   /* external initial encoding, if any */
    void           *ids;        /* Hash table for ID attributes if any */
    void           *refs;       /* Hash table for IDREFs attributes if any */
    const xmlChar  *URL;	/* The URI for that document */
    int             charset;    /* encoding of the in-memory content
				   actually an xmlCharEncoding */
};

xmlDocPtr

typedef xmlDoc *xmlDocPtr;

xmlChildrenNode

#define xmlChildrenNode children

xmlRootNode

#define xmlRootNode children

baseDTD

extern xmlNsPtr baseDTD;

oldXMLWDcompatibility

extern int oldXMLWDcompatibility;/* maintain compatibility with old WD */

xmlIndentTreeOutput

extern int xmlIndentTreeOutput;  /* try to indent the tree dumps */

xmlBufferAllocScheme

extern xmlBufferAllocationScheme xmlBufferAllocScheme; /* alloc scheme to use */

xmlSaveNoEmptyTags

extern int xmlSaveNoEmptyTags;   /* save empty tags as <empty></empty> */

xmlBufferCreate ()

xmlBufferPtr xmlBufferCreate                (void);

routine to create an XML buffer.

Returns :

the new structure.

xmlBufferCreateSize ()

xmlBufferPtr xmlBufferCreateSize            (size_t size);

routine to create an XML buffer.

`size` :	initial size of buffer
Returns :	the new structure.

xmlBufferFree ()

void        xmlBufferFree                   (xmlBufferPtr buf);

Frees an XML buffer.

buf : the buffer to free

xmlBufferDump ()

int         xmlBufferDump                   (FILE *file,
                                             xmlBufferPtr buf);

Dumps an XML buffer to a FILE *.

`file` :	the file output
`buf` :	the buffer to dump
Returns :	the number of xmlChar written

xmlBufferAdd ()

void        xmlBufferAdd                    (xmlBufferPtr buf,
                                             const xmlChar *str,
                                             int len);

Add a string range to an XML buffer. if len == -1, the lenght of str is recomputed.

`buf` :	the buffer to dump
`str` :	the xmlChar string
`len` :	the number of xmlChar to add

xmlBufferAddHead ()

void        xmlBufferAddHead                (xmlBufferPtr buf,
                                             const xmlChar *str,
                                             int len);

Add a string range to the beginning of an XML buffer. if len == -1, the lenght of str is recomputed.

`buf` :	the buffer
`str` :	the xmlChar string
`len` :	the number of xmlChar to add

xmlBufferCat ()

void        xmlBufferCat                    (xmlBufferPtr buf,
                                             const xmlChar *str);

Append a zero terminated string to an XML buffer.

`buf` :	the buffer to dump
`str` :	the xmlChar string

xmlBufferCCat ()

void        xmlBufferCCat                   (xmlBufferPtr buf,
                                             const char *str);

Append a zero terminated C string to an XML buffer.

`buf` :	the buffer to dump
`str` :	the C char string

xmlBufferShrink ()

int         xmlBufferShrink                 (xmlBufferPtr buf,
                                             int len);

Remove the beginning of an XML buffer.

`buf` :	the buffer to dump
`len` :	the number of xmlChar to remove
Returns :	the number of xmlChar removed, or -1 in case of failure.

xmlBufferGrow ()

int         xmlBufferGrow                   (xmlBufferPtr buf,
                                             int len);

Grow the available space of an XML buffer.

`buf` :	the buffer
`len` :	the minimum free sie to allocate
Returns :	the new available space or -1 in case of error

xmlBufferEmpty ()

void        xmlBufferEmpty                  (xmlBufferPtr buf);

empty a buffer.

buf : the buffer

xmlBufferContent ()

const xmlChar* xmlBufferContent             (const xmlBufferPtr buf);

`buf` :	the buffer to resize
Returns :	the internal content

xmlBufferUse ()

int         xmlBufferUse                    (const xmlBufferPtr buf);

`buf` :
Returns :

xmlBufferSetAllocationScheme ()

void        xmlBufferSetAllocationScheme    (xmlBufferPtr buf,
                                             xmlBufferAllocationScheme scheme);

Sets the allocation scheme for this buffer

`buf` :	the buffer to free
`scheme` :	allocation scheme to use

xmlBufferLength ()

int         xmlBufferLength                 (const xmlBufferPtr buf);

`buf` :	the buffer
Returns :	the length of data in the internal content

xmlCreateIntSubset ()

xmlDtdPtr   xmlCreateIntSubset              (xmlDocPtr doc,
                                             const xmlChar *name,
                                             const xmlChar *ExternalID,
                                             const xmlChar *SystemID);

Create the internal subset of a document

`doc` :	the document pointer
`name` :	the DTD name
`ExternalID` :	the external ID
`SystemID` :	the system ID
Returns :	a pointer to the new DTD structure

xmlNewDtd ()

xmlDtdPtr   xmlNewDtd                       (xmlDocPtr doc,
                                             const xmlChar *name,
                                             const xmlChar *ExternalID,
                                             const xmlChar *SystemID);

Creation of a new DTD for the external subset. To create an internal subset, use xmlCreateIntSubset().

`doc` :	the document pointer
`name` :	the DTD name
`ExternalID` :	the external ID
`SystemID` :	the system ID
Returns :	a pointer to the new DTD structure

xmlFreeDtd ()

void        xmlFreeDtd                      (xmlDtdPtr cur);

Free a DTD structure.

cur : the DTD structure to free up

xmlNewGlobalNs ()

xmlNsPtr    xmlNewGlobalNs                  (xmlDocPtr doc,
                                             const xmlChar *href,
                                             const xmlChar *prefix);

Creation of a Namespace, the old way using PI and without scoping DEPRECATED !!! It now create a namespace on the root element of the document if found.

`doc` :	the document carrying the namespace
`href` :	the URI associated
`prefix` :	the prefix for the namespace
Returns :	NULL this functionnality had been removed

xmlNewNs ()

xmlNsPtr    xmlNewNs                        (xmlNodePtr node,
                                             const xmlChar *href,
                                             const xmlChar *prefix);

Creation of a new Namespace. This function will refuse to create a namespace with a similar prefix than an existing one present on this node.

`node` :	the element carrying the namespace
`href` :	the URI associated
`prefix` :	the prefix for the namespace
Returns :	returns a new namespace pointer or NULL

xmlFreeNs ()

void        xmlFreeNs                       (xmlNsPtr cur);

Free up the structures associated to a namespace

cur : the namespace pointer

xmlNewDoc ()

xmlDocPtr   xmlNewDoc                       (const xmlChar *version);

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

xmlFreeDoc ()

void        xmlFreeDoc                      (xmlDocPtr cur);

Free up all the structures used by a document, tree included.

cur : pointer to the document @:

xmlNewDocProp ()

xmlAttrPtr  xmlNewDocProp                   (xmlDocPtr doc,
                                             const xmlChar *name,
                                             const xmlChar *value);

Create a new property carried by a document.

`doc` :	the document
`name` :	the name of the attribute
`value` :	the value of the attribute
Returns :	a pointer to the attribute

xmlNewProp ()

xmlAttrPtr  xmlNewProp                      (xmlNodePtr node,
                                             const xmlChar *name,
                                             const xmlChar *value);

Create a new property carried by a node.

`node` :	the holding node
`name` :	the name of the attribute
`value` :	the value of the attribute
Returns :	a pointer to the attribute

xmlNewNsProp ()

xmlAttrPtr  xmlNewNsProp                    (xmlNodePtr node,
                                             xmlNsPtr ns,
                                             const xmlChar *name,
                                             const xmlChar *value);

Create a new property tagged with a namespace and carried by a node.

`node` :	the holding node
`ns` :	the namespace
`name` :	the name of the attribute
`value` :	the value of the attribute
Returns :	a pointer to the attribute

xmlFreePropList ()

void        xmlFreePropList                 (xmlAttrPtr cur);

Free a property and all its siblings, all the children are freed too.

cur : the first property in the list

xmlFreeProp ()

void        xmlFreeProp                     (xmlAttrPtr cur);

Free one attribute, all the content is freed too

cur : an attribute

xmlCopyProp ()

xmlAttrPtr  xmlCopyProp                     (xmlNodePtr target,
                                             xmlAttrPtr cur);

Do a copy of the attribute.

`target` :	the element where the attribute will be grafted
`cur` :	the attribute
Returns :	a new xmlAttrPtr, or NULL in case of error.

xmlCopyPropList ()

xmlAttrPtr  xmlCopyPropList                 (xmlNodePtr target,
                                             xmlAttrPtr cur);

Do a copy of an attribute list.

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

xmlCopyDtd ()

xmlDtdPtr   xmlCopyDtd                      (xmlDtdPtr dtd);

Do a copy of the dtd.

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

xmlCopyDoc ()

xmlDocPtr   xmlCopyDoc                      (xmlDocPtr doc,
                                             int recursive);

Do a copy of the document info. If recursive, the content tree will be copied too as well as Dtd, namespaces and entities.

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

xmlNewDocNode ()

xmlNodePtr  xmlNewDocNode                   (xmlDocPtr doc,
                                             xmlNsPtr ns,
                                             const xmlChar *name,
                                             const xmlChar *content);

Creation of a new node element within a document. ns and content are optionnal (NULL). NOTE: content is supposed to be a piece of XML CDATA, so it allow entities references, but XML special chars need to be escaped first by using xmlEncodeEntitiesReentrant(). Use xmlNewDocRawNode() if you don't need entities support.

`doc` :	the document
`ns` :	namespace if any
`name` :	the node name
`content` :	the XML text content if any
Returns :	a pointer to the new node object.

xmlNewDocRawNode ()

xmlNodePtr  xmlNewDocRawNode                (xmlDocPtr doc,
                                             xmlNsPtr ns,
                                             const xmlChar *name,
                                             const xmlChar *content);

Creation of a new node element within a document. ns and content are optionnal (NULL).

`doc` :	the document
`ns` :	namespace if any
`name` :	the node name
`content` :	the text content if any
Returns :	a pointer to the new node object.

xmlNewNode ()

xmlNodePtr  xmlNewNode                      (xmlNsPtr ns,
                                             const xmlChar *name);

Creation of a new node element. ns and content are optionnal (NULL). If content is non NULL, a child list containing the TEXTs and ENTITY_REFs node will be created.

`ns` :	namespace if any
`name` :	the node name
Returns :	a pointer to the new node object.

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

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

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 optionnal (NULL). If content is non NULL, a child TEXT node will be created containing the string content.

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

xmlNewDocText ()

xmlNodePtr  xmlNewDocText                   (xmlDocPtr doc,
                                             const xmlChar *content);

Creation of a new text node within a document.

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

xmlNewText ()

xmlNodePtr  xmlNewText                      (const xmlChar *content);

Creation of a new text node.

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

xmlNewPI ()

xmlNodePtr  xmlNewPI                        (const xmlChar *name,
                                             const xmlChar *content);

Creation of a processing instruction element.

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

xmlNewDocTextLen ()

xmlNodePtr  xmlNewDocTextLen                (xmlDocPtr doc,
                                             const xmlChar *content,
                                             int len);

Creation of a new text node with an extra content lenght parameter. The text node pertain to a given document.

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

xmlNewTextLen ()

xmlNodePtr  xmlNewTextLen                   (const xmlChar *content,
                                             int len);

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

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

xmlNewDocComment ()

xmlNodePtr  xmlNewDocComment                (xmlDocPtr doc,
                                             const xmlChar *content);

Creation of a new node containing a commentwithin a document.

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

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.

xmlNewCDataBlock ()

xmlNodePtr  xmlNewCDataBlock                (xmlDocPtr doc,
                                             const xmlChar *content,
                                             int len);

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.

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.

xmlNewReference ()

xmlNodePtr  xmlNewReference                 (xmlDocPtr doc,
                                             const xmlChar *name);

Creation of a new reference node.

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

xmlCopyNode ()

xmlNodePtr  xmlCopyNode                     (xmlNodePtr node,
                                             int recursive);

Do a copy of the node.

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

xmlCopyNodeList ()

xmlNodePtr  xmlCopyNodeList                 (xmlNodePtr node);

Do a recursive copy of the node list.

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

xmlNewDocFragment ()

xmlNodePtr  xmlNewDocFragment               (xmlDocPtr doc);

Creation of a new Fragment node.

`doc` :	the document owning the fragment
Returns :	a pointer to the new node object.

xmlDocGetRootElement ()

xmlNodePtr  xmlDocGetRootElement            (xmlDocPtr doc);

Get the root element of the document (doc->children is a list containing possibly comments, PIs, etc ...).

`doc` :	the document
Returns :	the xmlNodePtr for the root or NULL

xmlGetLastChild ()

xmlNodePtr  xmlGetLastChild                 (xmlNodePtr parent);

Search the last child of a node.

`parent` :	the parent node
Returns :	the last child or NULL if none.

xmlNodeIsText ()

int         xmlNodeIsText                   (xmlNodePtr node);

Is this node a Text node ?

`node` :	the node
Returns :	1 yes, 0 no

xmlIsBlankNode ()

int         xmlIsBlankNode                  (xmlNodePtr node);

Is this node a Text node ?

`node` :	the node
Returns :	1 yes, 0 no

xmlDocSetRootElement ()

xmlNodePtr  xmlDocSetRootElement            (xmlDocPtr doc,
                                             xmlNodePtr root);

Set the root element of the document (doc->children is a list containing possibly comments, PIs, etc ...).

`doc` :	the document
`root` :	the new document root element
Returns :	the old root element if any was found

xmlNodeSetName ()

void        xmlNodeSetName                  (xmlNodePtr cur,
                                             const xmlChar *name);

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 changed
`name` :	the new tag name

xmlAddChild ()

xmlNodePtr  xmlAddChild                     (xmlNodePtr parent,
                                             xmlNodePtr cur);

Add a new child element, to parent, at the end of the child list.

`parent` :	the parent node
`cur` :	the child node
Returns :	the child or NULL in case of error.

xmlReplaceNode ()

xmlNodePtr  xmlReplaceNode                  (xmlNodePtr old,
                                             xmlNodePtr cur);

Unlink the old node from it's current context, prune the new one at the same place. If cur was already inserted in a document it is first unlinked from its existing context.

`old` :	the old node
`cur` :	the node
Returns :	the old node

xmlAddSibling ()

xmlNodePtr  xmlAddSibling                   (xmlNodePtr cur,
                                             xmlNodePtr elem);

Add a new element elem to the list of siblings of cur If the new element was already inserted in a document it is first unlinked from its existing context.

`cur` :	the child node
`elem` :	the new node
Returns :	the new element or NULL in case of error.

xmlAddPrevSibling ()

xmlNodePtr  xmlAddPrevSibling               (xmlNodePtr cur,
                                             xmlNodePtr elem);

Add a new element elem as the previous siblings of cur If the new element was already inserted in a document it is first unlinked from its existing context.

tree

Name

Synopsis

Description

Details

enum xmlElementType

xmlChar

CHAR

BAD_CAST

struct xmlNotation

xmlNotationPtr

enum xmlAttributeType

enum xmlAttributeDefault

struct xmlEnumeration

xmlEnumerationPtr

struct xmlAttribute

xmlAttributePtr

enum xmlElementContentType

enum xmlElementContentOccur

struct xmlElementContent

xmlElementContentPtr

enum xmlElementTypeVal

struct xmlElement

xmlElementPtr

enum xmlNsType

struct xmlNs

xmlNsPtr

struct xmlDtd

xmlDtdPtr

struct xmlAttr

xmlAttrPtr

struct xmlID

xmlIDPtr

struct xmlRef

xmlRefPtr

enum xmlBufferAllocationScheme

struct xmlBuffer

xmlBufferPtr

struct xmlNode

xmlNodePtr

struct xmlDoc

xmlDocPtr

xmlChildrenNode

xmlRootNode

baseDTD

oldXMLWDcompatibility

xmlIndentTreeOutput

xmlBufferAllocScheme

xmlSaveNoEmptyTags

xmlBufferCreate ()

xmlBufferCreateSize ()

xmlBufferFree ()

xmlBufferDump ()

xmlBufferAdd ()

xmlBufferAddHead ()

xmlBufferCat ()

xmlBufferCCat ()

xmlBufferShrink ()

xmlBufferGrow ()

xmlBufferEmpty ()

xmlBufferContent ()

xmlBufferUse ()

xmlBufferSetAllocationScheme ()

xmlBufferLength ()

xmlCreateIntSubset ()

xmlNewDtd ()

xmlFreeDtd ()

xmlNewGlobalNs ()

xmlNewNs ()

xmlFreeNs ()

xmlNewDoc ()

xmlFreeDoc ()

xmlNewDocProp ()

xmlNewProp ()

xmlNewNsProp ()

xmlFreePropList ()

xmlFreeProp ()

xmlCopyProp ()

xmlCopyPropList ()

xmlCopyDtd ()