XML (version 3.99-0.17)

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)

Value

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

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.

Author

Duncan Temple Lang

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

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

See Also

xmlChildren xmlTreeParse

Examples

if (FALSE) {
 doc <- xmlTreeParse("https://www.omegahat.net/Scripts/Data/mtcars.xml")
 xmlElementsByTagName(doc$children[[1]], "variable")
}

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