devela 0.28.0

A development substrate of coherence.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

// devela::phys::time::no
//
//! Not a time.
//

use crate::{Ordering, TimePoint, TimeScale, TimeSource, TimeSpan};

#[doc = crate::_tags!(no time)]
/// Represents the absence of time.
#[doc = crate::_doc_meta!{location("phys/time")}]
///
/// This can be used anywhere an implementation of a time-related trait or
/// a time component is expected, serving as a no-op placeholder.
///
/// # Notes
/// - This is a type alias for `()`, so you cannot use `NoTime` as a constructor.
///   Instead, use the unit value directly (`()`).
///
/// # Examples
/// ```
/// # use devela::{NoTime, TimeSplit};
/// let split = TimeSplit::new_hour_nano(12u8, 30u8, 45u8, 500u16, (), ());
/// ```
pub type NoTime = ();

#[rustfmt::skip]
impl TimePoint for NoTime {
    type Elapsed = NoTime;
    fn time_cmp(_a: Self, _b: Self) -> Ordering { Ordering::Equal }
    fn time_elapsed_checked(_later: Self, _earlier: Self) -> Option<Self::Elapsed> { None }
    fn time_elapsed(_later: Self, _earlier: Self) -> Self::Elapsed { }
}
#[rustfmt::skip]
impl TimeSpan for NoTime {
    const TIME_ZERO: Self = ();
    fn time_is_zero(self) -> bool { true }
    fn time_add_checked(self, _other: Self) -> Option<Self> { None }
    fn time_sub_checked(self, _other: Self) -> Option<Self> { None }
}
#[rustfmt::skip]
impl TimeSource<NoTime> for NoTime {
    fn time_is_monotonic() -> bool { true }
    fn time_is_absolute() -> bool { true }
    fn time_scale() -> TimeScale { TimeScale::Seconds }
    fn time_now() -> NoTime { }
    fn time_point_value(_point: NoTime) -> u64 { 0 }
    fn time_elapsed_value(_elapsed: NoTime) -> u64 { 0 }
    fn time_now_millis_f64() -> f64 { f64::NAN }
}