Struct fj_kernel::stores::HandleWrapper

pub struct HandleWrapper<T>(pub Handle<T>);

A wrapper around Handle to define equality based on identity

This is a utility type that implements Eq/PartialEq and other common traits that are based on those, based on the identity of object that the wrapped handle references. This is useful, if a type of object doesn’t implement Eq/PartialEq, which means handles referencing it won’t implement those types either.

Typically, if an object doesn’t implement Eq/PartialEq, it will do so for good reason. If you need something that represents the object and implements those missing traits, you might want to be explicit about what you’re doing, and access its ID via Handle::id instead.

But if you have a struct that owns a Handle to such an object, and you want to be able to derive various traits that are not available for the Handle itself, this wrapper is for you.

Tuple Fields

0: Handle<T>

Methods from Deref<Target = Handle<T>>

pub fn id(&self) -> ObjectId

Access this pointer’s unique id

pub fn clone_object(&self) -> Twhere
    T: Clone,

Return a clone of the object this handle refers to

Trait Implementations

impl<T> Clone for HandleWrapper<T>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T> Debug for HandleWrapper<T>

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

Formats the value using the given formatter.

impl<T> Deref for HandleWrapper<T>

type Target = Handle<T>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> From<Handle<T>> for HandleWrapper<T>

fn from(handle: Handle<T>) -> Self

Converts to this type from the input type.

impl<T> From<HandleWrapper<T>> for Handle<T>

fn from(wrapper: HandleWrapper<T>) -> Self

Converts to this type from the input type.

impl<T> Hash for HandleWrapper<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,

Feeds a slice of this type into the given Hasher.

impl<T> Ord for HandleWrapper<T>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: PartialOrd<Self>,

Restrict a value to a certain interval.

impl<T> PartialEq<HandleWrapper<T>> for HandleWrapper<T>

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<T> PartialOrd<HandleWrapper<T>> for HandleWrapper<T>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<T> Eq for HandleWrapper<T>

impl<T> Send for HandleWrapper<T>

impl<T> Sync for HandleWrapper<T>