EVOLUTION-MANAGER
Edit File: xmlToList.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: Convert an XML node/document to a more R-like list</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <link rel="stylesheet" type="text/css" href="R.css" /> </head><body> <table width="100%" summary="page for xmlToList {XML}"><tr><td>xmlToList {XML}</td><td style="text-align: right;">R Documentation</td></tr></table> <h2>Convert an XML node/document to a more R-like list</h2> <h3>Description</h3> <p>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> </code> 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")</code> (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></code>. </p> <h3>Usage</h3> <pre> xmlToList(node, addAttributes = TRUE, simplify = FALSE) </pre> <h3>Arguments</h3> <table summary="R argblock"> <tr valign="top"><td><code>node</code></td> <td> <p>the XML node or document to be converted to an R list. This can be an "internal" or C-level node (i.e. <code><a href="XMLNode-class.html">XMLInternalNode-class</a></code>) or a regular R-level node (either <code><a href="XMLNode-class.html">XMLNode-class</a></code> or <code>XMLHashNode</code>).</p> </td></tr> <tr valign="top"><td><code>addAttributes</code></td> <td> <p>a logical value which controls whether the attributes of an empty node are added to the </p> </td></tr> <tr valign="top"><td><code>simplify</code></td> <td> <p>a logical value that controls whether we collapse the list to a vector if the elements all have a common compatible type. Basically, this controls whether we use <code>sapply</code> or <code>lapply</code>. </p> </td></tr> </table> <h3>Value</h3> <p>A list whose elements correspond to the children of the top-level nodes. </p> <h3>Author(s)</h3> <p>Duncan Temple Lang</p> <h3>See Also</h3> <p><code><a href="xmlTreeParse.html">xmlTreeParse</a></code> <code><a href="getNodeSet.html">getNodeSet</a></code> and <code><a href="getNodeSet.html">xpathApply</a></code> <code><a href="xmlRoot.html">xmlRoot</a></code>, <code><a href="xmlChildren.html">xmlChildren</a></code>, <code><a href="xmlApply.html">xmlApply</a></code>, <code>[[</code>, etc. for accessing the content of XML nodes. </p> <h3>Examples</h3> <pre> tt = '<x> <a>text</a> <b foo="1"/> <c bar="me"> <d>a phrase</d> </c> </x>' doc = xmlParse(tt) xmlToList(doc) # use an R-level node representation doc = xmlTreeParse(tt) xmlToList(doc) </pre> <hr /><div style="text-align: center;">[Package <em>XML</em> version 3.99-0.3 <a href="00Index.html">Index</a>]</div> </body></html>