XML: xmlParseDoc – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

xmlParseDoc

Parse an XML document with options controlling the parser.

Description

This function is a generalization of xmlParse that parses an XML document. With this function, we can specify a combination of different options that control the operation of the parser. The options control many different aspects the parsing process

Usage

xmlParseDoc(file, options = 1L, encoding = character(),
            asText = !file.exists(file), baseURL = file)

Arguments

`file`	the name of the file or URL or the XML content itself
`options`	options controlling the behavior of the parser. One specifies the different options as elements of an integer vector. These are then bitwised OR'ed together. The possible options are `RECOVER`, `NOENT`, `DTDLOAD`, `DTDATTR`, `DTDVALID`, `NOERROR`, `NOWARNING`, `PEDANTIC`, `NOBLANKS`, `SAX1`, `XINCLUDE`, `NONET`, `NODICT`, `NSCLEAN`, `NOCDATA`, `NOXINNODE`, `COMPACT`, `OLD10`, `NOBASEFIX`, `HUGE`, `OLDSAX`. ( These options are also listed in the (non-exported) variable `parserOptions`.)
`encoding`	character string that provides the encoding of the document if it is not explicitly contained within the document itself.
`asText`	a logical value indicating whether `file` is the XML content (`TRUE`) or the name of a file or URL (`FALSE`)
`baseURL`	the base URL used for resolving relative documents, e.g. XIncludes. This is important if `file` is the actual XML content rather than a URL

Value

An object of class XMLInternalDocument.

Author(s)

Duncan Temple Lang

References

libxml2

Examples

f = system.file("exampleData", "mtcars.xml", package="XML")
     # Same as xmlParse()
 xmlParseDoc(f)

 txt =
     '<top xmlns:r="http://www.r-project.org">
        <b xmlns:r="http://www.r-project.org">
          <c xmlns:omg="http:/www.omegahat.net"/>
        </b>
      </top>'

 xmlParseDoc(txt,  NSCLEAN, asText = TRUE)

 txt =
     '<top xmlns:r="http://www.r-project.org"  xmlns:r="http://www.r-project.org">
        <b xmlns:r="http://www.r-project.org">
          <c xmlns:omg="http:/www.omegahat.net"/>
        </b>
      </top>'

 xmlParseDoc(txt, c(NSCLEAN, NOERROR), asText = TRUE)

XML

Tools for Parsing and Generating XML Within R and S-Plus

v3.99-0.10

BSD_3_clause + file LICENSE

Authors

CRAN Team [ctb, cre] (de facto maintainer since 2013), Duncan Temple Lang [aut] (<https://orcid.org/0000-0003-0159-1546>), Tomas Kalibera [ctb]

Initial release