uCalc API Version: 5.7.0-preview.1 Released: 7/30/2026
Warning
uCalc API Preview Release Notice:This preview documentation describes the intended behavior of the API. It is not fully accurate or complete.The current preview build contains incomplete features, unoptimized performance, and is subject to breaking changes.Use of the preview version in your production code is not recommended.
Retrieves the internal, low-level identifier for the uCalc item.
Returns the internal handle of the current Item. While typed as an Item for convenience, it represents an opaque identifier whose numeric value is not guaranteed to be consistent across application runs.
This method retrieves the internal handle of an Item object. Handles are opaque, pointer-like identifiers used by the uCalc library to manage objects. This method is primarily intended for advanced debugging and internal diagnostics.
A handle is a unique, low-level identifier for a specific uCalc Item in memory. Its actual numeric value is unpredictable and can change every time the application runs. It should not be stored or used for serialization.
For a stable and predictable identifier, use MemoryIndex instead.
Handle vs. MemoryIndexIt is crucial to understand the difference between these two identifiers:
| Feature | Handle | MemoryIndex |
|---|---|---|
| Stability | Volatile. Changes between application runs. | Stable. Predictable and sequential. |
| Uniqueness | Guaranteed unique for the 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. |
| Use Case | Advanced debugging. | Identifying specific instances for logging or in diagnostic tools. |
In C# or C++, you can think of a handle as being similar to an IntPtr or a raw pointer (void*). It refers to a specific memory location managed by the uCalc engine. However, unlike raw pointers, the uCalc handle is managed within the uCalc ecosystem. The key takeaway for developers is to use MemoryIndex for any form of stable identification and to treat the Handle as a transient, internal-only value.