xml.DomDocument.createTextNode

Creates an XML Text DomNode object for a DomDocument object.

Syntax

createTextNode(
   text STRING )  
  RETURNING object xml.DomNode
  1. text is the data of the XML Text node.

Usage

Creates an XML Text DomNode object for this DomDocument object, where text is the data of the XML Text node, or NULL.

Returns a DomNode object, or NULL.

Only the characters #x9, #xA, #xD, [#x20-#xD7FF], [#xE000-#xFFFD] and [#x10000-#x10FFFF] are allowed in the content of an XML Text node. The save() and normalize() methods will fail if characters other than those allowed exist in a Text node.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).