Previous Next

WRITE-CHARACTERS( ) method
Adds character data to an XML document represented by a SAX-writer object.
Return type:
Applies to:
 
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 "&lt;".
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.

Previous Next
© 2013 Progress Software Corporation and/or its subsidiaries or affiliates.