Retrieves the internal handle of a uCalc object using its class type and memory index.
Warning
uCalc API Preview Release Notice:The uCalc engine has successfully transitioned to modern cross-platform environments.The next phase envolves some structural changes, performance optimizations, and API refinements.The API is subject to breaking changes prior to the stable release. Please evaluate the preview version thoroughly before production use.
The internal handle of the object at the specified index. Returns 0 if no object is found.
The MemoryObjectAddress method is a low-level diagnostic tool used to retrieve an object's internal handle by using its stable memory index. It is primarily intended for advanced debugging and internal diagnostics.
Given an object's memory index (obtained from a method like Item.MemoryIndex()), this function returns the corresponding object Handle, which is an opaque identifier used internally by the uCalc library.
It is critical to understand the difference between these two identifiers:
| Feature | Handle | Memory Index |
|---|---|---|
| Stability | Volatile. A handle's value is unpredictable and can change between application runs. | Stable. Memory indices are predictable and generally sequential. |
| Uniqueness | Guaranteed unique for an object's lifetime. | Can be recycled after an object is released. |
| Purpose | Low-level object identification for the C++ core. | High-level diagnostics and tracking object lifetime. |
This function bridges the gap between the two, allowing you to find a volatile handle using a stable index.
Note: This is a static function and is not called on a
uCalcinstance.