Previous Next

COPY-SAX-ATTRIBUTES( ) method
Performs a deep copy of a SAX-attributes object.
Typically, this method is used to capture the contents of the SAX-attributes object automatically created, populated, and destroyed by the SAX parser during the scope of a call to the startElement callback procedure. For example, to preserve the attributes of an XML element outside of the startElement procedure, you create a SAX-attributes object outside the scope of the startElement callback and use this method on the handle of the new object. The handle to the new SAX-attributes object could then be passed, for example, as a parameter to the START-ELEMENT( ) method of a SAX-writer object. In this way, you can easily program a concurrent SAX read/write routine.
The copy deletes any previous contents of the target handle and replaces them with the contents of the source handle. Remember, if you explicitly create SAX-attributes objects using the CREATE SAX-ATTRIBUTES statement, you must explicitly delete the objects when your copying operations complete.
Return type:
Applies to:
This is the syntax to invoke this method:
 
Syntax 
target-handle:COPY-SAX-ATTRIBUTES ( source-handle )
target-handle
A handle to a valid SAX-attributes object. The contents of this SAX-attributes object handle will be overwritten by the contents of the SAX-attributes object of the source-handle.
source-handle
A handle to a valid SAX-attributes object. The contents of this SAX-attributes object overwrites the contents of the SAX-attributes object on which you call this method.
The following is an example:
 
hWrite-SAX-attributes:COPY-SAX-ATTRIBUTES( hRead-SAX-attributes ).

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