Handles

This is the handles section of niso_runtime.h, owned by niso-core and kept in crates/niso-core/include/handles.h. The build composes it with the other sections in the order crates/niso-compose/sections.txt gives.

Functions: niso_retain, niso_release, niso_object_interface, niso_object_get_owner

int32_t niso_retain(niso_dom* dom, niso_handle handle);
int32_t niso_release(niso_dom* dom, niso_handle handle);

The most derived interface of a handle (a NISO_IFACE_* value), or 0 if the handle is invalid.

uint32_t niso_object_interface(niso_dom* dom, niso_handle handle);

The node or window an object belongs to when the DOM makes it once for that owner and hands it out again ([SameObject] attributes, a node’s style sheet and rules, the window’s singletons), else 0. A binding keeps the object’s wrapper alive with its owner’s, so its identity and expandos last as long as the owner does.

int32_t niso_object_get_owner(niso_dom* dom, niso_handle handle, niso_handle* owner);