Struct PointerDereferencer 

pub struct PointerDereferencer<P> { /* private fields */ }

Updatable, Getter, Settable, and TimeGetter are passed through Box, Rc<RefCell<T>>, Arc<RwLock<T>>, and Arc<Mutex<T>>, but this cannot be done safely for references involving raw pointer dereferencing. This is a wrapper struct that provides this functionality for *mut T, *const RwLock<T>, and *const Mutex<T>. It’s constructor is unsafe fn, so this is considered sound.

Implementations

impl<P> PointerDereferencer<P>

pub const unsafe fn new(pointer: P) -> Self

The constructor for PointerDereferencer. Although this constructor itself does not run any unsafe code, it is unsafe fn since this type inherently performs unsafe functions. See the type documentation for more information.

Although it is technically possible to construct a PointerDereferencer<P> where P is not a raw pointer, there is no valid reason to do so and the object would be entirely useless.

pub fn into_ptr(self) -> P

Returns the inner pointer that the wrapper contains by consuming it. Due to the fact that pointers are Copy, copy_ptr, which does not consume self and is const fn, is preferred in almost all cases however.

impl<P: Clone> PointerDereferencer<P>

pub fn clone_ptr(&self) -> P

Clones and returns the inner pointer that the wrapper contains. Due to the fact that pointers are Copy, copy_ptr is nearly always preferred both for clarity and because it is const fn however.

impl<P: Copy> PointerDereferencer<P>

pub const fn copy_ptr(&self) -> P

This function is be identical to clone_ptr when P: Copy. However, copy_ptr should be preferred where possible because, unlike clone_inner, it is const fn. It is also clearer that the clone is very light.

impl<T> PointerDereferencer<*mut T>

These functions get a PointerDereferencer<*mut dyn Trait> from a PointerDereferencer<*mut T> where T: Trait. Because raw pointers are Copy, they only require &self and do not consume the original PointerDereferencer. Unfortunately T currently must be Sized due to language limitations.

pub const fn as_dyn_updatable<E: Clone + Debug>( &self, ) -> PointerDereferencer<*mut dyn Updatable<E> + '_>

where T: Updatable<E>,

pub const fn as_dyn_getter<U, E: Clone + Debug>( &self, ) -> PointerDereferencer<*mut dyn Getter<U, E> + '_>

where T: Getter<U, E>,

pub const fn as_dyn_settable<U, E: Clone + Debug>( &self, ) -> PointerDereferencer<*mut dyn Settable<U, E> + '_>

where T: Settable<U, E>,

pub const fn as_dyn_time_getter<E: Clone + Debug>( &self, ) -> PointerDereferencer<*mut dyn TimeGetter<E> + '_>

where T: TimeGetter<E>,

pub const fn as_dyn_chronology<U>( &self, ) -> PointerDereferencer<*mut dyn Chronology<U> + '_>

where T: Chronology<U>,

impl<T> PointerDereferencer<*const RwLock<T>>

These functions get a PointerDereferencer<*const RwLock<dyn Trait>> from a PointerDereferencer<*const RwLock<T>> where T: Trait. Because raw pointers are Copy, they only require &self and do not consume the original PointerDereferencer. Unfortunately T currently must be Sized due to language limitations.

pub const fn as_dyn_updatable<E: Clone + Debug>( &self, ) -> PointerDereferencer<*const RwLock<dyn Updatable<E> + '_>>

where T: Updatable<E>,

pub const fn as_dyn_getter<U, E: Clone + Debug>( &self, ) -> PointerDereferencer<*const RwLock<dyn Getter<U, E> + '_>>

where T: Getter<U, E>,

pub const fn as_dyn_settable<U, E: Clone + Debug>( &self, ) -> PointerDereferencer<*const RwLock<dyn Settable<U, E> + '_>>

where T: Settable<U, E>,

pub const fn as_dyn_time_getter<E: Clone + Debug>( &self, ) -> PointerDereferencer<*const RwLock<dyn TimeGetter<E> + '_>>

where T: TimeGetter<E>,

impl<T> PointerDereferencer<*const Mutex<T>>

These functions get a PointerDereferencer<*const Mutex<dyn Trait>> from a PointerDereferencer<*const Mutex<T>> where T: Trait. Because raw pointers are Copy, they only require &self and do not consume the original PointerDereferencer. Unfortunately T currently must be Sized due to language limitations.

pub const fn as_dyn_updatable<E: Clone + Debug>( &self, ) -> PointerDereferencer<*const Mutex<dyn Updatable<E> + '_>>

where T: Updatable<E>,

pub const fn as_dyn_getter<U, E: Clone + Debug>( &self, ) -> PointerDereferencer<*const Mutex<dyn Getter<U, E> + '_>>

where T: Getter<U, E>,

pub const fn as_dyn_settable<U, E: Clone + Debug>( &self, ) -> PointerDereferencer<*const Mutex<dyn Settable<U, E> + '_>>

where T: Settable<U, E>,

pub const fn as_dyn_time_getter<E: Clone + Debug>( &self, ) -> PointerDereferencer<*const Mutex<dyn TimeGetter<E> + '_>>

where T: TimeGetter<E>,

impl<T> PointerDereferencer<*const T>

pub const fn as_dyn_chronology<U>( &self, ) -> PointerDereferencer<*const dyn Chronology<U> + '_>

where T: Chronology<U>,

Trait Implementations

impl<T, C: ?Sized + Chronology<T>> Chronology<T> for PointerDereferencer<*mut C>

fn get(&self, time: Time) -> Option<Datum<T>>

Get a value at a time.

impl<T, C: ?Sized + Chronology<T>> Chronology<T> for PointerDereferencer<*const C>

fn get(&self, time: Time) -> Option<Datum<T>>

Get a value at a time.

impl<P: Clone> Clone for PointerDereferencer<P>

fn clone(&self) -> PointerDereferencer<P>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Copy> Copy for PointerDereferencer<P>

impl<P: Debug> Debug for PointerDereferencer<P>

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

Formats the value using the given formatter.

impl<P: Eq> Eq for PointerDereferencer<P>

impl<T, G: ?Sized + Getter<T, E>, E: Clone + Debug> Getter<T, E> for PointerDereferencer<*mut G>

fn get(&self) -> Output<T, E>

Get something, fallibly, with a timestamp.

fn update_and_get(&mut self) -> Output<G, E>

Update with Updatable and then call get.

impl<G: ?Sized + Getter<T, E>, T, E: Clone + Debug> Getter<T, E> for PointerDereferencer<*const RwLock<G>>

Available on crate feature std only.

fn get(&self) -> Output<T, E>

Get something, fallibly, with a timestamp.

fn update_and_get(&mut self) -> Output<G, E>

Update with Updatable and then call get.

impl<G: ?Sized + Getter<T, E>, T, E: Clone + Debug> Getter<T, E> for PointerDereferencer<*const Mutex<G>>

Available on crate feature std only.

fn get(&self) -> Output<T, E>

Get something, fallibly, with a timestamp.

fn update_and_get(&mut self) -> Output<G, E>

Update with Updatable and then call get.

impl<P: PartialEq> PartialEq for PointerDereferencer<P>

fn eq(&self, other: &PointerDereferencer<P>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<T, S: ?Sized + Settable<T, E>, E: Clone + Debug> Settable<T, E> for PointerDereferencer<*mut S>

fn set(&mut self, value: T) -> NothingOrError<E>

Set something to a value. For example, this could set a motor to a voltage.

impl<S: ?Sized + Settable<T, E>, T, E: Clone + Debug> Settable<T, E> for PointerDereferencer<*const RwLock<S>>

Available on crate feature std only.

fn set(&mut self, value: T) -> NothingOrError<E>

Set something to a value. For example, this could set a motor to a voltage.

impl<S: ?Sized + Settable<T, E>, T, E: Clone + Debug> Settable<T, E> for PointerDereferencer<*const Mutex<S>>

Available on crate feature std only.

fn set(&mut self, value: T) -> NothingOrError<E>

Set something to a value. For example, this could set a motor to a voltage.

impl<P: PartialEq> StructuralPartialEq for PointerDereferencer<P>

impl<TG: ?Sized + TimeGetter<E>, E: Clone + Debug> TimeGetter<E> for PointerDereferencer<*mut TG>

fn get(&self) -> TimeOutput<E>

Get the time.

impl<TG: ?Sized + TimeGetter<E>, E: Clone + Debug> TimeGetter<E> for PointerDereferencer<*const RwLock<TG>>

Available on crate feature std only.

fn get(&self) -> TimeOutput<E>

Get the time.

impl<TG: ?Sized + TimeGetter<E>, E: Clone + Debug> TimeGetter<E> for PointerDereferencer<*const Mutex<TG>>

Available on crate feature std only.

fn get(&self) -> TimeOutput<E>

Get the time.

impl<U: ?Sized + Updatable<E>, E: Clone + Debug> Updatable<E> for PointerDereferencer<*mut U>

fn update(&mut self) -> NothingOrError<E>

As this trait is very generic, exactly what this does will be very dependent on the implementor.

impl<U: ?Sized + Updatable<E>, E: Clone + Debug> Updatable<E> for PointerDereferencer<*const RwLock<U>>

Available on crate feature std only.

fn update(&mut self) -> NothingOrError<E>

As this trait is very generic, exactly what this does will be very dependent on the implementor.

impl<U: ?Sized + Updatable<E>, E: Clone + Debug> Updatable<E> for PointerDereferencer<*const Mutex<U>>

Available on crate feature std only.

fn update(&mut self) -> NothingOrError<E>

As this trait is very generic, exactly what this does will be very dependent on the implementor.