Struct Handle 

pub struct Handle<T> { /* private fields */ }

A typed, generational reference to a value stored in a Pool<T>.

See the module docs for the representation and variance rationale.

Implementations

impl<T> Handle<T>

pub const fn index(self) -> u32

The slot index this handle points at.

pub const fn generation(self) -> u32

The generation this handle was issued with.

Never zero — see the module docs.

pub const fn to_bits(self) -> u64

Packs the handle into a u64 (generation in the high half).

The packed form is stable and never zero, which makes it safe to use as a wire/serialization representation with 0 reserved for “none”.

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

Unpacks a handle produced by Handle::to_bits.

Returns None if the generation half is zero, which no real handle ever has.

pub const fn cast<U>(self) -> Handle<U>

Reinterprets the handle as naming a different type.

Useful only at seams that erase types (e.g. a generic resource table); the result is meaningless in any other pool.

Trait Implementations

impl<T> Clone for Handle<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Copy for Handle<T>

impl<T> Debug for Handle<T>

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

Formats the value using the given formatter.

impl<T> Eq for Handle<T>

impl<T> Hash for Handle<T>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T> PartialEq for Handle<T>

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

Equality operator ==.

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

Inequality operator !=.