Enum TimingError 

#[non_exhaustive]
pub enum TimingError {
    NoBoardingStop {
        leg: usize,
        route: RouteIdx,
        from_stop: StopIdx,
    },
    NoCatchableTrip {
        leg: usize,
        route: RouteIdx,
        board_pos: u32,
        at: SecondOfDay,
    },
    UnreachableAlight {
        leg: usize,
        route: RouteIdx,
        board_pos: u32,
        alight: StopIdx,
    },
}

Failure modes for Journey::with_timing.

Each variant carries the leg index where reconstruction stopped (zero-based) and enough context to identify what went wrong. For a Journey produced by the same timetable the algorithm ran against, the only variant a caller realistically hits is TimingError::NoBoardingStop – and only when a transfer needs a walk chain longer than one direct footpath hop. The other two variants surface programmer errors (a Journey matched against a different timetable, a custom adapter violating the no-overtaking contract).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NoBoardingStop

No stop in the plan-reconstruction frontier (the previous leg’s alight stop or any of its one-hop footpath neighbours) is served by the route this leg wants to board. Multi-hop walk chains are not reconstructed – if the original journey actually walked through more than one intermediate stop, that walk can’t be recovered from Journey.plan alone today.

Fields

leg: usize

Zero-based plan index where reconstruction stopped.

route: RouteIdx

The route this leg wanted to board.

from_stop: StopIdx

The stop the rider was at when reconstruction stopped (the previous leg’s alight stop, or self.origin for leg == 0).

NoCatchableTrip

No trip on the boarded route departs at or after the rider’s available time. For a Journey produced by the same timetable this should not happen – surface as a programmer-error escape hatch.

Fields

leg: usize

Zero-based plan index where reconstruction stopped.

route: RouteIdx

The route this leg boarded.

board_pos: u32

The position within route where the rider boarded.

at: SecondOfDay

The time at which the rider was ready to board.

UnreachableAlight

The boarded route’s stop sequence (from the boarding position onwards) does not include the claimed alighting stop. For a Journey produced by the same timetable this should not happen – surface as a programmer-error escape hatch.

Fields

leg: usize

Zero-based plan index where reconstruction stopped.

route: RouteIdx

The route this leg boarded.

board_pos: u32

The position within route where the rider boarded.

alight: StopIdx

The stop the plan claimed the rider alighted at.

Trait Implementations

impl Clone for TimingError

fn clone(&self) -> TimingError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimingError

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

Formats the value using the given formatter.

impl Display for TimingError

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

Formats the value using the given formatter.

impl Error for TimingError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.