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, callSTM_STRING_RETAIN(<str>)
on that string before callingSTM_DISPOSE_MEMORY()
.
Input/Output The string to be retained in memory after performingSTM_DISPOSE_MEMORY()
STRING str;
STM_STRING_RETAIN(str)