xml.DomDocument.createProcessingInstruction

Creates an XML Processing Instruction DomNode object for this DomDocument object.

Syntax

createProcessingInstruction(
   target STRING,
   data STRING )
  RETURNING object xml.DomNode
  1. target is the target part of the XML Processing Instruction.
  2. data is the data part of the XML Processing Instruction.

Usage

Creates an XML Processing Instruction DomNode object for this DomDocument object, where target is the target part of the XML Processing Instruction, cannot be NULL; data is the data part of the XML Processing Instruction, 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 Processing Instruction node.

The character sequence (Double-Hyphen) '--' is not allowed in the content of an XML Processing Instruction. The save() and normalize() methods will fail if this sequence or characters other than those allowed exist in a Processing Instruction 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).