Description Usage Arguments Details Value Author(s) See Also Examples
Finds all XML elements in an XML document that lie on a certain path, regardless of where exactly the path is found in the XML document. Sub-elements (children) of the elements on the search path are returned, too.
1 | fxml_findPath(xmlflat.df, path, attr.only = NULL, attr.not = NULL)
|
xmlflat.df |
A flat XML dataframe created with |
path |
A character vector representing the path to be searched. Each element of the vector is a hierarchy level in the XML document. Example: |
attr.only |
A list of named vectors representing attribute/value combinations the XML elements on the search path must match.
The name of an element in the list is the XML elment name to which the attribute belongs. The list element itself is a named vector.
The vector's elements represent different attributes (= the names of the vector elements) and their values (= vector elements).
Example: |
attr.not |
A list of vectors representing attribute/value combinations the XML elements on the search path must not match to be included in the results. See argument |
With fxml_findPath()
it does not matter where exactly in the hierarchy of the XML document the path is found. If, for example, path = c("tag1", "tag2")
then
the element with full XML path <xml><testdoc><tag1><tag2>
would be found, too.
Other fxml_findPath...()
functions allow for different search modes:
fxml_findPathRoot
: Search for path from the root node of the XML document downwards. Sub-elements are returned, too.
fxml_findPathFull
: Search for exact path (always starting from the root node). No sub-elements returned, as they have a different path than the search path.
fxml_findPathBottom
: Search for path from the bottom of the element hierarchy in the XML document.
The IDs (xmlflat.df$elemid.
) of the XML elements that are located on the provided path. Sub-elements of the elements on the search path are returned, too. NULL
, if no elements where found.
Joachim Zuckarelli joachim@zuckarelli.de
fxml_findPathRoot
, fxml_findPathFull
, fxml_findPathBottom
1 2 3 4 5 6 7 8 9 10 11 12 13 | # Load example file with population data from United Nations Statistics Division
# and create flat dataframe
example <- system.file("worldpopulation.xml", package="flatxml")
xml.dataframe <- fxml_importXMLFlat(example)
# Find all XML elements with <data><record><field> in their XML path
path <- c("data", "record", "field")
fxml_findPath(xml.dataframe, path)
# Find only those XML elements with <data><record><field> in their XML path that have the
# "name" attribute of the <field> element set to "Sex"
path <- c("data", "record", "field")
fxml_findPath(xml.dataframe, path, attr.only = list(field = c(name = "Sex")))
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.