xmlValue function

Extract or set the contents of a leaf XML node

Some types of XML nodes have no children nodes, but are leaf nodes and simply contain text. Examples are XMLTextMode, XMLProcessingInstruction. This function provides access to their raw contents. This has been extended to operate recursivel on arbitrary XML nodes that contain a single text node.

xmlValue(x, ignoreComments = FALSE, recursive = TRUE,
          encoding = getEncoding(x), trim = FALSE)

Arguments

• x: the XMLNode object whose contents are to be returned.

• ignoreComments: a logical value which, if TRUE

  does not include the text in XML comment nodes. If this is FALSE, the text in the comments is part of the return value.

• recursive: a logical value indicating whether to process all sub-nodes (TRUE) or only the text nodes within the node x.

• encoding: experimental functionality and parameter related to encoding.

• trim: a logical value controlling whether we remove leading or trailing white space when returning the string value

Returns

The object stored in the value slot of the XMLNode object. This is typically a string.

References

https://www.w3.org/XML/, http://www.jclark.com/xml/, https://www.omegahat.net

Author(s)

Duncan Temple Lang

See Also

xmlChildren

xmlName

xmlAttrs

xmlNamespace

Examples

node <- xmlNode("foo", "Some text")
 xmlValue(node)

 xmlValue(xmlTextNode("some more raw text"))

  # Setting the xmlValue().
 a = newXMLNode("a")
 xmlValue(a) = "the text"
 xmlValue(a) = "different text"

 a = newXMLNode("x", "bob")
 xmlValue(a) = "joe"

 b = xmlNode("bob")
 xmlValue(b) = "Foo"
 xmlValue(b) = "again"

 b = newXMLNode("bob", "some text")
 xmlValue(b[[1]]) = "change"
 b