xml.DomDocument.createEntityReference

Creates a XML EntityReference DomNode object for a DomDocument object

Syntax

createEntityReference(
   entity STRING )  
  RETURNS xml.DomNode
  1. entity defines the name of the entity reference.

Usage

Creates a XML EntityReference DomNode object for this DomDocument object, where entity is the name of the entity reference.

Returns the XML element DomNode object, or NULL.

An Entity Reference node is read-only and cannot be modified.

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