Progress
External Program
Interfaces
Characters
Invoked when the XML parser detects character data.
charData
A MEMPTR that contains a chunk of character data.
numChars
The number of characters contained in the MEMPTR.
NOTE: If a character requires more than one byte to encode, the value of numChars might not match the value returned by MEMPTR:GETSIZE().The parser calls this method to report each chunk of character data. It might report contiguous character data in one chunk, or split it into several chunks. If validation is enabled, whitespace is reported by the IgnorableWhitespace callback.
Although it is not intended for the application to call Characters directly, the application can. Whoever calls Characters must free the charData MEMPTR. When Progress calls Characters, Progress is responsible for freeing the charData MEMPTR (although if the application frees it, no harm results). If the application calls Characters, the application is responsible for freeing the charData MEMPTR.
To copy the charData MEMPTR such that the memory used by the copy is completely separate from the memory used by the original, use 4GL assignment, which performs a deep copy. The following fragment demonstrates this:
For more information on 4GL assignment, see the Progress Language Referen ce.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |