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:

LOGICAL

Applies to:

SAX-attributes object handle

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 ).