swh:1:snp:7d9f1bc35e120776766db9334626062f837c20ad
Tip revision: db230f20006a0b7edc98fff17930bcdba29e22dd authored by Duncan Temple Lang on 21 July 2008, 00:00:00 UTC
version 1.96-0
version 1.96-0
Tip revision: db230f2
xmlNamespace.Rd
\name{xmlNamespace}
\alias{xmlNamespace}
\alias{xmlNamespace.XMLNode}
\alias{xmlNamespace.XMLInternalNode}
\alias{xmlNamespace.character}
\alias{XMLNamespace-class}
\title{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 \code{xmlNamespace(xmlRoot(doc))}.
The class of the result is
is an S3-style object of class \code{XMLNamespace}.
}
\usage{
xmlNamespace(x)
}
\arguments{
\item{x}{the object whose namespace is to be computed}
}
\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:
\item{id}{the identifier by which other nodes refer to this
namespace.}
\item{uri}{the URI or location that defines this namespace.}
\item{local}{? (can't remember off-hand).}
}
\references{\url{http://www.w3.org/XML}, \url{http://www.jclark.com/xml},
\url{http://www.omegahat.org} }
\author{ Duncan Temple Lang }
\seealso{
\code{\link{xmlName}}
\code{\link{xmlChildren}}
\code{\link{xmlAttrs}}
\code{\link{xmlValue}}
\code{\link{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 is a comment, get the sibling.
xmlNamespace(getSibling(xmlRoot(doc)))
xmlNamespace(getSibling(xmlRoot(doc))[[1]][[1]])
node <- xmlNode("arg", xmlNode("name", "foo"), namespace="R")
xmlNamespace(node)
}
\keyword{file}