XML (version 3.99-0.5)

xmlElementsByTagName: Retrieve the children of an XML node with a specific tag name

Description

This returns a list of the children or sub-elements of an XML node whose tag name matches the one specified by the user.

Usage

xmlElementsByTagName(el, name, recursive = FALSE)

Arguments

el

the node whose matching children are to be retrieved.

name

a string giving the name of the tag to match in each of el's children.

recursive

a logical value. If this is FALSE, the default, only the direct child nodes are searched. Alternatively, if this is TRUE, all sub-nodes at all levels are searched. In other words, we find all descendants of the node el and return a list with the nodes having the given name. The relationship between the nodes in the resulting list cannot be determined. This is a set of nodes. See the note.

Value

A list containing those child nodes of el whose tag name matches that specified by the user.

Details

This does a simple matching of names and subsets the XML node's children list. If recursive is TRUE, then the function is applied recursively to the children of the given node and so on.

References

http://www.w3.org/XML, http://www.omegahat.net/RSXML,

See Also

xmlChildren xmlTreeParse

Examples

# NOT RUN {
 doc <- xmlTreeParse("http://www.omegahat.net/Scripts/Data/mtcars.xml")
 xmlElementsByTagName(doc$children[[1]], "variable")
# }
# NOT RUN {
 doc <- xmlTreeParse(system.file("exampleData", "mtcars.xml", package="XML"))
 xmlElementsByTagName(xmlRoot(doc)[[1]], "variable")
# }