TestHeapConsistency

Function TestHeapConsistency

Performs series of internal tests on the internal memory heap to detect whether any internal memory corruption has occurred. This is a diagnostic routine used for detecting and diagnosing bugs in Analytica itself. Theoretically, heap corruption should never occur. If any heap corruption is detected, you should save your work, exit and restart Analytica, and then report any activities that may have lead up to the detected corruption to support@lumina.com.

For the most part, this function is intended for internal Lumina usage and is not officially supported.

Declaration

TestHeapConsistency(ShowErr: optional boolean atomic = false)

Parameters:

ShowErr

If True, an error is reported if any corruption is detected.

Return Value

Returns 1 if everything appears to be okay (self-consistent), 0 if corruption has been detected.

When the return value is 0, there is definitely corrupted memory. If the return value is 1, this indicates only that no corruption was detected. It is possible that some corruption could go undetected, since the function examines only the consistency of the heap structure.

If there is corruption of the heap, there is also a remote possibility that the function could hang or crash while being evaluated.

See Also

• Memory usage and management