Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : WRITE-CHARACTERS( ) method
 

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 "&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.