xml.DomDocument.createEntityReference

Creates an XML EntityReference DomNode object for a DomDocument object

Syntax

createEntityReference(
   ref STRING )  
  RETURNING object xml.DomNode

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

Returns a 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 with the appropriate error number.