Utility Functions : List of Utility Functions : stm_string_retain

stm_string_retain
Description:
When used in a DOC template, STM_DISPOSE_MEMORY() frees temporary memory used by the DOC system. If you want to avoid freeing a specific string, for example, general strings used in the template, call STM_STRING_RETAIN(<str>) on that string before calling STM_DISPOSE_MEMORY().
Syntax
stm_string_retain(string)
Arguments
 
Input/Output
The string to be retained in memory after performing STM_DISPOSE_MEMORY()
Status Codes
None
Example
STRING str;
STM_STRING_RETAIN(str)