xml.DomNode.prependChildElement

Creates and adds a child XML Element node to the beginning of the list of child nodes for this XML Element DomNode object.

Syntax

prependChildElement(
   name STRING )
  RETURNING object xml.DomNode

name is the name of the XML element to add.

Usage

Creates and adds a child XML Element node to the beginning of the list of child nodes for this XML Element DomNode object; name is the name of the XML element to add.

Returns the XML Element DomNode object, or NULL.

CAUTION:

Not part of W3C API.

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).