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