WRITE-CHARACTERS( ) method

Adds character data to an XML document represented by a SAX-writer object.

Return type: LOGICAL

Applies to: SAX-writer object handle

Syntax

WRITE-CHARACTERS ( { chardata | longchar } )

chardata: An expression that evaluates to a CHARACTER variable that contains the XML text.
longchar: An expression that evaluates to a LONGCHAR variable that contains the XML text.

Call this method to add character data to the XML document. Character data in an XML document belongs exclusively in leaf nodes. (A leaf node is a bottom node; one that does not have any child nodes in a hierarchical tree structure, like an XML document.) Character data cannot appear outside of the root (document) node.

This method sets the status to SAX-WRITE-CONTENT.

The method escapes all special characters according to the XML specification. For example, "<" is changed to "<".

If the STRICT attribute is TRUE and the call would result in CHARACTER data being written at the document level (that is, outside of the root node), then the method fails.