Struct NodeHandle 

pub struct NodeHandle {
    pub entity: Entity,
    pub generation: u32,
}

Opaque handle to a live element: an Entity plus the generation it carried when the handle was minted. Resolving a handle validates the generation, so a handle to a despawned entity returns None rather than addressing whatever entity later reused that index.

Fields

entity: Entity

The referenced entity (index + generation).

generation: u32

The entity’s generation bits at mint time, kept for the packed wire form and for cross-checking after an unpack.

Implementations

impl NodeHandle

pub fn new(entity: Entity) -> Self

Mint a handle for entity, capturing its current generation.

pub fn pack(self) -> u64

Pack into the u64 wire form used by the C-ABI LumenNode and by hosts whose value type can hold 64 bits. The layout is Entity::to_bits (index in the low half, generation in the high half); treat it as opaque and round-trip only through Self::unpack.

pub fn unpack(bits: u64) -> Option<Self>

Reconstruct from the packed wire form. Returns None for bits that never came from Self::pack (invalid index), never panicking.

pub fn validate(&self, entities: &Entities) -> Option<Entity>

Resolve against the live entity allocator: Some(entity) when the exact (index, generation) is still alive, None when it has been despawned (stale handle). Never panics.

Trait Implementations

impl Clone for NodeHandle

fn clone(&self) -> NodeHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NodeHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for NodeHandle

fn eq(&self, other: &NodeHandle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for NodeHandle

impl Eq for NodeHandle

impl StructuralPartialEq for NodeHandle