Struct Observed 

pub struct Observed<T, U = ()> { /* private fields */ }

Value with its observation time and quality.

T is the value; U the uncertainty type (see Quality). Transparent to the value (Observed::value, Observed::map); answers age and staleness.

Implementations

impl<T, U> Observed<T, U>

pub const fn new(value: T, taken_at: Instant<Utc>, quality: Quality<U>) -> Self

Wraps a value with its time and quality.

pub const fn value(&self) -> &T

Value.

pub fn into_value(self) -> T

Unwraps the value.

pub const fn taken_at(&self) -> Instant<Utc>

Observation time.

pub const fn quality(&self) -> &Quality<U>

Quality.

pub fn age_at(&self, now: Instant<Utc>) -> Result<Duration>

Age at now.

Computed, never stored.

Errors

KernelError::TimeReversed if now precedes the observation (clock stepped back, or a future timestamp).

pub fn is_stale_at(&self, now: Instant<Utc>, limit: Duration) -> bool

Whether older than limit at now.

false for a reading timestamped after now; that error is reported by Observed::age_at.

pub fn map<V>(self, derive: impl FnOnce(T) -> V) -> Observed<V, U>

Derives another value, keeping time and quality.

For quantities computed from the value alone (e.g. course from a fix velocity). A derivation that changes the uncertainty should build a new Observed.

Trait Implementations

impl<T: Clone, U: Clone> Clone for Observed<T, U>

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, U: Copy> Copy for Observed<T, U>

impl<T: Debug, U: Debug> Debug for Observed<T, U>

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

Formats the value using the given formatter.

impl<T: PartialEq, U: PartialEq> PartialEq for Observed<T, U>

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

Equality operator ==.

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

Inequality operator !=.

impl<T: PartialEq, U: PartialEq> StructuralPartialEq for Observed<T, U>