Create internal XML node or document object

DESCRIPTION:

These are used to create internal `libxml' nodes and top-level document objects that are used to write XML trees. While the functions are available, their direct use is not encouraged. Instead, use as the functions need to be used within a strict regime to avoid corrupting C level structures.

USAGE:

newXMLDoc(dtd, namespaces=NULL)
newXMLNode(name, ..., attrs = NULL, namespace="", doc=NULL)

ARGUMENTS:

dtd
the name of the DTD to use for the XML document.
namespaces
a named character vector with each element specifying a name space identifier and the corresponding URI for that namespace that are to be declared and used in the XML document, \ e.g. c(shelp = "http://www.omegahat.org/XML/SHelp")
name
the tag/element name for the XML node
...
the children of this node. These can be other nodes created earlier or Splus strings that are converted to text nodes and added as children to this newly created node.
attrs
a named list of name-value pairs to be used as attributes for the XML node.
namespace
the short or alias for the namespace to use for this XML node
doc
the XMLInternalDocument object created with newXMLDoc that is used to root the node.

DETAILS:

These create internal C level objects/structure instances that can be added to a libxml DOM and subsequently inserted into other document objects or "serialized" to textual form.

VALUE:

Each function returns an Splus object that points to the C-level structure instance. These are of class XMLInternalDocument and XMLInternalNode, respectively

NOTE:

These functions are used to build up an internal XML tree. This can be used in the Sxslt package ( http://www.omegahat.org/Sxslt) when creating content in Splus that is to be dynamically inserted into an XML document.

AUTHOR(S):

Duncan Temple Lang

REFERENCES:

http://www.w3.org/XML, http://www.xmlsoft.org, http://www.omegahat.org

SEE ALSO:

,