xml.DomDocument.createProcessingInstruction
Creates a XML Processing Instruction xml.DomNode
object for this xml.DomDocument
object.
Syntax
createProcessingInstruction(
target STRING,
data STRING )
RETURNS xml.DomNode
- target defines the target part of the XML Processing Instruction.
- data defines the data part of the XML Processing Instruction.
Returns an xml.DomNode
object.
Usage
Creates a XML Processing Instruction xml.DomNode
object for this
xml.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 xml.DomNode
object.
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).