Struct Datum 

pub struct Datum<T> {
    pub time: Time,
    pub value: T,
}

A container for a time and something else, usually an f32 or a State.

Fields

time: Time

Timestamp for the datum. This should probably be absolute.

value: T

The thing with the timestamp.

Implementations

impl<T> Datum<T>

pub const fn new(time: Time, value: T) -> Datum<T>

Constructor for Datum type.

Examples found in repository

examples/devices.rs (line 56)

    fn get(&self) -> Output<State, ()> {
        println!("Encoder returning state {:?}", STATE);
        Ok(Some(Datum::new(self.time, STATE)))
    }

examples/pid.rs (lines 130-133)

    fn get(&self) -> Output<Quantity, ()> {
        Ok(Some(Datum::new(
            self.time,
            Quantity::from(self.time) * Quantity::new(0.5, MILLIMETER_PER_SECOND),
        )))
    }

pub fn replace_if_older_than(&mut self, maybe_replace_with: Self) -> bool

Replaces self with maybe_replace_with if maybe_replace_with’s timestamp is newer than self’s. Returns true if self was replaced and false otherwise.

Trait Implementations

impl<T: Add<Output = O>, O> Add<T> for Datum<T>

type Output = Datum<O>

The resulting type after applying the + operator.

fn add(self, other: T) -> Datum<O>

Performs the + operation.

impl<T: Add<Output = O>, O> Add for Datum<T>

type Output = Datum<O>

The resulting type after applying the + operator.

fn add(self, other: Self) -> Datum<O>

Performs the + operation.

impl<T: AddAssign> AddAssign<T> for Datum<T>

fn add_assign(&mut self, other: T)

Performs the += operation.

impl<T: AddAssign> AddAssign for Datum<T>

fn add_assign(&mut self, other: Self)

Performs the += operation.

impl<T: Clone> Clone for Datum<T>

fn clone(&self) -> Datum<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Datum<T>

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

Formats the value using the given formatter.

impl Div<Datum<f32>> for Datum<Command>

type Output = Datum<Command>

The resulting type after applying the / operator.

fn div(self, other: Datum<f32>) -> Self

Performs the / operation.

impl Div<Datum<f32>> for Datum<State>

type Output = Datum<State>

The resulting type after applying the / operator.

fn div(self, other: Datum<f32>) -> Self

Performs the / operation.

impl<T: Div<Output = O>, O> Div<T> for Datum<T>

type Output = Datum<O>

The resulting type after applying the / operator.

fn div(self, other: T) -> Datum<O>

Performs the / operation.

impl Div<f32> for Datum<Command>

type Output = Datum<Command>

The resulting type after applying the / operator.

fn div(self, other: f32) -> Self

Performs the / operation.

impl Div<f32> for Datum<State>

type Output = Datum<State>

The resulting type after applying the / operator.

fn div(self, other: f32) -> Self

Performs the / operation.

impl<T: Div<Output = O>, O> Div for Datum<T>

type Output = Datum<O>

The resulting type after applying the / operator.

fn div(self, other: Self) -> Datum<O>

Performs the / operation.

impl DivAssign<Datum<f32>> for Datum<Command>

fn div_assign(&mut self, other: Datum<f32>)

Performs the /= operation.

impl DivAssign<Datum<f32>> for Datum<State>

fn div_assign(&mut self, other: Datum<f32>)

Performs the /= operation.

impl<T: DivAssign> DivAssign<T> for Datum<T>

fn div_assign(&mut self, other: T)

Performs the /= operation.

impl DivAssign<f32> for Datum<Command>

fn div_assign(&mut self, other: f32)

Performs the /= operation.

impl DivAssign<f32> for Datum<State>

fn div_assign(&mut self, other: f32)

Performs the /= operation.

impl<T: DivAssign> DivAssign for Datum<T>

fn div_assign(&mut self, other: Self)

Performs the /= operation.

impl Mul<Datum<f32>> for Datum<Command>

type Output = Datum<Command>

The resulting type after applying the * operator.

fn mul(self, other: Datum<f32>) -> Self

Performs the * operation.

impl Mul<Datum<f32>> for Datum<State>

type Output = Datum<State>

The resulting type after applying the * operator.

fn mul(self, other: Datum<f32>) -> Self

Performs the * operation.

impl<T: Mul<Output = O>, O> Mul<T> for Datum<T>

type Output = Datum<O>

The resulting type after applying the * operator.

fn mul(self, other: T) -> Datum<O>

Performs the * operation.

impl Mul<f32> for Datum<Command>

type Output = Datum<Command>

The resulting type after applying the * operator.

fn mul(self, other: f32) -> Self

Performs the * operation.

impl Mul<f32> for Datum<State>

type Output = Datum<State>

The resulting type after applying the * operator.

fn mul(self, other: f32) -> Self

Performs the * operation.

impl<T: Mul<Output = O>, O> Mul for Datum<T>

type Output = Datum<O>

The resulting type after applying the * operator.

fn mul(self, other: Self) -> Datum<O>

Performs the * operation.

impl MulAssign<Datum<f32>> for Datum<Command>

fn mul_assign(&mut self, other: Datum<f32>)

Performs the *= operation.

impl MulAssign<Datum<f32>> for Datum<State>

fn mul_assign(&mut self, other: Datum<f32>)

Performs the *= operation.

impl<T: MulAssign> MulAssign<T> for Datum<T>

fn mul_assign(&mut self, other: T)

Performs the *= operation.

impl MulAssign<f32> for Datum<Command>

fn mul_assign(&mut self, other: f32)

Performs the *= operation.

impl MulAssign<f32> for Datum<State>

fn mul_assign(&mut self, other: f32)

Performs the *= operation.

impl<T: MulAssign> MulAssign for Datum<T>

fn mul_assign(&mut self, other: Self)

Performs the *= operation.

impl<T: Neg<Output = O>, O> Neg for Datum<T>

type Output = Datum<O>

The resulting type after applying the - operator.

fn neg(self) -> Datum<O>

Performs the unary - operation.

impl<T: Not<Output = O>, O> Not for Datum<T>

type Output = Datum<O>

The resulting type after applying the ! operator.

fn not(self) -> Datum<O>

Performs the unary ! operation.

impl<T: PartialEq> PartialEq for Datum<T>

fn eq(&self, other: &Datum<T>) -> 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<E: Copy + Debug> Settable<Datum<Command>, E> for Terminal<'_, E>

fn get_settable_data_ref(&self) -> &SettableData<Datum<Command>, E>

As traits cannot have fields, get functions and separate types are required. All you have to do is make a field for a corresponding SettableData, make this return an immutable reference to it, and make get_settable_data_mut return a mutable reference to it.

fn get_settable_data_mut(&mut self) -> &mut SettableData<Datum<Command>, E>

As traits cannot have fields, get functions and separate types are required. All you have to do is make a field for a corresponding SettableData, make this return a mutable reference to it, and make get_settable_data_ref return an immutable reference to it.

fn impl_set(&mut self, _command: Datum<Command>) -> NothingOrError<E>

Set something, not updating the internal SettableData. Due to current limitations of the language, you must implement this but call set. Do not call this directly as it will make get_last_request work incorrectly.

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

Set something to a value. For example, this could set a motor to a voltage. You should call this and not impl_set.

fn follow(&mut self, getter: Reference<dyn Getter<S, E>>)

Begin following a Getter of the same type. For this to work, you must have update_following_data in your Updatable implementation.

fn stop_following(&mut self)

Stop following the Getter.

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

Get a new value from the Getter we’re following, if there is one, and call set accordingly. You must add this to your Updatable implementation if you are following Getters. This is a current limitation of the Rust language. If specialization is ever stabilized, this will hopefully be done in a better way.

fn get_last_request(&self) -> Option<S>

Get the argument from the last time set was called.

impl<E: Copy + Debug> Settable<Datum<State>, E> for Terminal<'_, E>

fn get_settable_data_ref(&self) -> &SettableData<Datum<State>, E>

As traits cannot have fields, get functions and separate types are required. All you have to do is make a field for a corresponding SettableData, make this return an immutable reference to it, and make get_settable_data_mut return a mutable reference to it.

fn get_settable_data_mut(&mut self) -> &mut SettableData<Datum<State>, E>

As traits cannot have fields, get functions and separate types are required. All you have to do is make a field for a corresponding SettableData, make this return a mutable reference to it, and make get_settable_data_ref return an immutable reference to it.

fn impl_set(&mut self, _state: Datum<State>) -> NothingOrError<E>

Set something, not updating the internal SettableData. Due to current limitations of the language, you must implement this but call set. Do not call this directly as it will make get_last_request work incorrectly.

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

Set something to a value. For example, this could set a motor to a voltage. You should call this and not impl_set.

fn follow(&mut self, getter: Reference<dyn Getter<S, E>>)

Begin following a Getter of the same type. For this to work, you must have update_following_data in your Updatable implementation.

fn stop_following(&mut self)

Stop following the Getter.

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

Get a new value from the Getter we’re following, if there is one, and call set accordingly. You must add this to your Updatable implementation if you are following Getters. This is a current limitation of the Rust language. If specialization is ever stabilized, this will hopefully be done in a better way.

fn get_last_request(&self) -> Option<S>

Get the argument from the last time set was called.

impl<T: Sub<Output = O>, O> Sub<T> for Datum<T>

type Output = Datum<O>

The resulting type after applying the - operator.

fn sub(self, other: T) -> Datum<O>

Performs the - operation.

impl<T: Sub<Output = O>, O> Sub for Datum<T>

type Output = Datum<O>

The resulting type after applying the - operator.

fn sub(self, other: Self) -> Datum<O>

Performs the - operation.

impl<T: SubAssign> SubAssign<T> for Datum<T>

fn sub_assign(&mut self, other: T)

Performs the -= operation.

impl<T: SubAssign> SubAssign for Datum<T>

fn sub_assign(&mut self, other: Self)

Performs the -= operation.

impl TryFrom<TerminalData> for Datum<Command>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: TerminalData) -> Result<Datum<Command>, ()>

Performs the conversion.

impl TryFrom<TerminalData> for Datum<State>

type Error = ()

The type returned in the event of a conversion error.

fn try_from(value: TerminalData) -> Result<Datum<State>, ()>

Performs the conversion.

impl<T: Copy> Copy for Datum<T>

impl<T: Eq> Eq for Datum<T>

impl<T> StructuralPartialEq for Datum<T>