xml.DomDocument.createProcessingInstruction

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

Syntax

createProcessingInstruction(
   target STRING,
   data STRING )
  RETURNS xml.DomNode
  1. target defines the target part of the XML Processing Instruction.
  2. data defines the data part of the XML Processing Instruction.

Usage

Creates a 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 the XML element 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).