catalogResolve: Look up an element via the XML catalog mechanism

View source: R/catalog.R

catalogResolveR Documentation

Look up an element via the XML catalog mechanism


XML parsers use a catalog to map generic system and public addresses to actual local files or potentially different remote files. We can use a catalog to map a reference such as to a particular directory on our local machine and then not have to modify any of the documents if we move the local files to another directory, e.g. install a new version in an alternate directory.

This function provides a mechanism to query the catalog to resolve a URI, PUBLIC or SYSTEM identifier.

This is now vectorized, so accepts a character vector of URIs and recycles type to have the same length.

If an entry is not resolved via the catalog system, a NA is returned for that element. To leave the value unaltered in this case, use asIs = TRUE .


catalogResolve(id, type = "uri", asIs = FALSE, debug = FALSE)



the name of the (generic) element to be resolved


a string, specifying whether the lookup is for a uri, system or public element


a logical. If TRUE any element of id which is not resolved by the catalog system will be left as given in the call. If FALSE, such unresolved elements are identified by NA.


logical value indicating whether to turn on debugging output written to the console (TRUE) or not (FALSE).


A character vector. If the element was resolved, the single element is the resolved value. Otherwise, the character vector will contain no elements.


Duncan Temple Lang

References provides a short, succinct tutorial on catalogs.

See Also



if(!exists("Sys.setenv")) Sys.setenv = Sys.putenv

Sys.setenv("XML_CATALOG_FILES" = system.file("exampleData", "catalog.xml", package = "XML"))

catalogResolve("-//OASIS//DTD DocBook XML V4.4//EN", "public")


catalogResolve("", "uri")
catalogResolve("", "uri")

  # This one does not resolve anything, returning an empty value.
catalogResolve("", "uri")

   # Vectorized and returns NA for the first and /tmp/html.xsl
   # for the second.

 catalogAdd("http://made.up.domain", "/tmp")
 catalogResolve(c("ddas", "http://made.up.domain/html.xsl"), asIs = TRUE)

XML documentation built on Nov. 3, 2023, 1:14 a.m.

Related to catalogResolve in XML...