xmlNamespace {XML} | R Documentation

## Retrieve the namespace value of an XML node.

### Description

Each XML node has a namespace identifier which is a string indicating in which DTD (Document Type Definition) the definition of that element can be found. This avoids the problem of having different document definitions using the same names for XML elements that have different meaning. To resolve the name space, i.e. i.e. find out to where the identifier points, one can use the expression `xmlNamespace(xmlRoot(doc))`.

The class of the result is is an S3-style object of class `XMLNamespace`.

### Usage

    xmlNamespace(x)
    xmlNamespace(x, ...) <- value

### Arguments

`x` | the object whose namespace is to be computed
`value` | the prefix for a namespace that is defined in the node or any of the ancestors.
`...` | additional arguments for setting the name space

### Value

For non-root nodes, this returns a string giving the identifier of the name space for this node. For the root node, this returns a list with 2 elements:

`id` | the identifier by which other nodes refer to this namespace.
`uri` | the URI or location that defines this namespace.
`local` | ? (can't remember off-hand).

### Author(s)

Duncan Temple Lang

### References

http://www.w3.org/XML, http://www.jclark.com/xml, http://www.omegahat.net

### See Also

`xmlName` `xmlChildren` `xmlAttrs` `xmlValue` `xmlNamespaceDefinitions`

### Examples

      doc <- xmlTreeParse(system.file("exampleData", "job.xml", package="XML"))
      xmlNamespace(xmlRoot(doc))
      xmlNamespace(xmlRoot(doc)[[1]][[1]])

      doc <- xmlInternalTreeParse(system.file("exampleData", "job.xml", package="XML"))
         # Since the first node, xmlRoot() will skip that, by default.
      xmlNamespace(xmlRoot(doc))
      xmlNamespace(xmlRoot(doc)[[1]][[1]])

      node <- xmlNode("arg", xmlNode("name", "foo"), namespace="R")
      xmlNamespace(node)

       doc = xmlParse('<top xmlns:r="http://www.r-project.org"><bob><code>a = 1:10</code></bob></top>')
       node = xmlRoot(doc)[[1]][[1]]
       xmlNamespace(node) = "r"
       node

       doc = xmlParse('<top xmlns:r="http://www.r-project.org"><bob><code>a = 1:10</code></bob></top>')
       node = xmlRoot(doc)[[1]][[1]]
       xmlNamespaces(node, set = TRUE) = c(omg = "http://www.omegahat.net")
       node

[Package XML version 3.98-1.5 Index]