XML (version 1.92-1)

xmlNamespaceDefinitions: Get definitions of any namespaces defined in this XML node

Description

If the given node has any namespace definitions declared within it, i.e. of the form xmlns:myNamespace="http://www.myNS.org", xmlNamespaceDefinitions provides access to these definitions. While they appear in the XML node in the document as attributes, they are treated differently by the parser and so do not show up in the nodes attributes via xmlAttrs.

getDefaultNamespace is used to get the default namespace for the top-level node in a document.

The recursive parameter allows one to conveniently find all the namespace definitions in a document or sub-tree without having to examine the file. This can be useful when working with XPath queries via getNodeSet.

Usage

xmlNamespaceDefinitions(x, addNames = TRUE, recursive = FALSE)
getDefaultNamespace(doc)

Arguments

x

the XMLNode object in which to find any namespace definitions

addNames

a logical indicating whether to compute the names for the elements in the resulting list. The names are convenient, but one can avoid the (very small) overhead of computing these with this parameter.

doc

the XMLInternalDocument object obtained from a call to xmlTreeParse(, useInternalNodes = TRUE)

recursive

a logical value indicating whether to extract the namespace definitions for just this node (FALSE) or all of the descendant nodes as well (TRUE). If this is TRUE, all the namespace definitions are col

Value

• A list with as many elements as there are namespace definitions. Each element is an object of class XMLNameSpace, containing fields giving the local identifier, the associated defining URI and a logical value indicating whether the definition is local to this node. The name of each element is the prefix or alias used for that namespace definition, i.e. the value of the id field in the namespace definition. For default namespaces, i.e. those that have no prefix/alias, the name is "".

concept

XML

References

http://www.w3.org/XML

See Also

xmlTreeParse xmlAttrs xmlGetAttr

Examples

f = system.file("exampleData", "longitudinalData.xml", package = "XML")
  n = xmlRoot(xmlTreeParse(f))
  xmlNamespaceDefinitions(n)
  xmlNamespaceDefinitions(n, recursive = TRUE)


  f = system.file("exampleData", "namespaces.xml", package = "XML")
  n = xmlRoot(xmlTreeParse(f, useInternal = TRUE))
  xmlNamespaceDefinitions(n)

  xmlNamespaceDefinitions(n, recursive = TRUE)