Struct CalibratedClock 

pub struct CalibratedClock { /* private fields */ }

Precision clock over a hardware counter, with transparent fallback.

Construct via CalibratedClock::new (falls back silently when the counter is unusable — the requested precision stays observable through Clock::source) or CalibratedClock::try_new (strict: construction fails when the counter cannot be calibrated). REQ-CLK-003.

Implementations

impl CalibratedClock

pub fn new(reps: u32) -> Self

Calibrate and construct; on any calibration failure construct the reference-clock fallback instead (never fails). reps scales the calibration workload (e.g. 1_000..=1_000_000).

pub fn try_new(reps: u32) -> Result<Self, CalError>

Strict construction: Err when the hardware counter is unusable.

Errors

Whatever calibrate reports (see its # Errors section) — the fallback constructor CalibratedClock::new is the transparent counterpart.

pub fn with_fallback() -> Self

Construct the explicit reference-clock fallback — opting out of the counter path entirely (useful when a consumer wants the conservative source by policy, not by calibration outcome).

pub fn with_calibration(cal: Calibration) -> Self

Construct directly from a pre-computed calibration (e.g. re-using a factor calibrated earlier in the process).

pub fn calibration(&self) -> Option<Calibration>

The active calibration, if the counter path is in use.

Trait Implementations

impl Clock for CalibratedClock

fn now(&self) -> Timestamp

Current reading. t.mono never decreases across calls within a process, even if the underlying source regresses. REQ-CLK-001.

fn quality(&self) -> SyncQuality

Advisory sync quality of the underlying source (G2 — a hint, never a guarantee). REQ-CLK-004.

fn source(&self) -> ClockSource

Which underlying source reads are actually served from. REQ-CLK-003.

impl Clone for CalibratedClock

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CalibratedClock

impl Debug for CalibratedClock

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

Formats the value using the given formatter.