newXMLDoc {XML} | R Documentation

## 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 `xmlTree` 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 R 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 R 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 R that is to be dynamicall 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

`xmlTree` `saveXML`

### Examples

[Package XML version 0.97-7 Index]