enum UI::ReleaseStrategy

Overview

Describes how a NativeHandle should release its underlying platform pointer.

Each strategy maps to a specific platform memory management model:

• ObjCRelease: The handle owns the pointer and will call objc_release when released. Use for ObjC objects that Crystal has retained (+1).

• ObjCBorrowed: The pointer is a borrowed reference from the ObjC runtime. Crystal does NOT own it and must NOT release it. Typical for class objects, method return values that are autoreleased, or pointers into parent containers.

• JNIGlobalRef: The pointer is a JNI global reference created via NewGlobalRef. Must be freed with DeleteGlobalRef via the JNI environment.

• Unowned: The pointer's lifetime is managed externally. The handle is a tag-only wrapper. No release action is taken. Used for stack-allocated values, pointers managed by another system, or testing with mock pointers.

Defined in:

Enum Members

ObjCRelease = 0

ObjCBorrowed = 1

JNIGlobalRef = 2

Unowned = 3

Instance Method Summary

• #jni_global_ref?

  Returns true if this enum value equals JNIGlobalRef

• #obj_c_borrowed?

  Returns true if this enum value equals ObjCBorrowed

• #obj_c_release?

  Returns true if this enum value equals ObjCRelease

• #unowned?

  Returns true if this enum value equals Unowned

Instance Method Detail