https://github.com/cran/XML
Tip revision: d8b36ec3455b754f80d5cfaaa3e5e249e28bcb08 authored by Duncan Temple Lang on 25 June 2009, 00:00:00 UTC
version 2.5-3
version 2.5-3
Tip revision: d8b36ec
xmlToList.Rd
\name{xmlToList}
\alias{xmlToList}
\title{Convert an XML node/document to a more R-like list}
\description{
This function is an early and simple approach to converting
an XML node or document into a more typical R list containing
the data values directly (rather than as XML nodes).
It is useful for dealing with data that is returned from
REST requests or other Web queries or generally when parsing
XML and wanting to be able to access the content
as elements in a list indexed by the name of the node.
For example, if given a node of the form
\code{
<x>
<a>text</a>
<b foo="1"/>
<c bar="me">
<d>a phrase</d>
</c>
</x>
}
We would end up with a list with elements named "a", "b" and "c".
"a" would be the string "text", b would contain the named character
vector \code{c(foo = "1")} (i.e. the attributes) and "c" would
contain the list with two elements named "d" and ".attrs".
The element corresponding to "d" is a
character vector with the single element "a phrase".
The ".attrs" element of the list is the character vector of
attributes from the node \code{<c>...</c>}.
}
\usage{
xmlToList(node, addAttributes = TRUE)
}
\arguments{
\item{node}{the XML node or document to be converted to an R list.
This can be an "internal" or C-level node (i.e. \code{\link{XMLInternalNode-class}})
or a regular R-level node (either \code{\link{XMLNode-class}} or \code{XMLHashNode}).}
\item{addAttributes}{a logical value which controls whether the attributes of an empty node
are added to the }
}
\value{
A list whose elements correspond to the children of the top-level nodes.
}
\author{Duncan Temple Lang}
\seealso{
\code{\link{xmlTreeParse}}
\code{\link{getNodeSet}} and \code{\link{xpathApply}}
\code{\link{xmlRoot}}, \code{\link{xmlChildren}}, \code{\link{xmlApply}}, \code{[[}, etc. for
accessing the content of XML nodes.
}
\examples{
tt =
'<x>
<a>text</a>
<b foo="1"/>
<c bar="me">
<d>a phrase</d>
</c>
</x>'
doc = xmlParse(tt)
xmlToList(doc)
doc = xmlTreeParse(tt)
xmlToList(doc)
}
\keyword{IO}
\keyword{data}