Enum SimError 

#[non_exhaustive]
pub enum SimError {
    InvalidConfig {
        field: &'static str,
        reason: String,
    },
    EntityNotFound(EntityId),
    StopNotFound(StopId),
    GroupNotFound(GroupId),
    RouteOriginMismatch {
        expected_origin: EntityId,
        route_origin: EntityId,
    },
    LineDoesNotServeStop {
        line_or_car: EntityId,
        stop: EntityId,
    },
    HallCallNotFound {
        stop: EntityId,
        direction: CallDirection,
    },
    WrongRiderPhase {
        rider: EntityId,
        expected: RiderPhaseKind,
        actual: RiderPhaseKind,
    },
    RiderHasNoStop(EntityId),
    EmptyRoute,
    NotAnElevator(EntityId),
    ElevatorDisabled(EntityId),
    WrongServiceMode {
        entity: EntityId,
        expected: ServiceMode,
        actual: ServiceMode,
    },
    NotAStop(EntityId),
    LineNotFound(EntityId),
    NoRoute {
        origin: EntityId,
        destination: EntityId,
        origin_groups: Vec<GroupId>,
        destination_groups: Vec<GroupId>,
    },
    AmbiguousRoute {
        origin: EntityId,
        destination: EntityId,
        groups: Vec<GroupId>,
    },
    SnapshotVersion {
        saved: String,
        current: String,
    },
    SnapshotFormat(String),
}

Errors that can occur during simulation setup or operation.

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.

InvalidConfig

Configuration is invalid.

Fields

field: &'static str

Which config field is problematic.

reason: String

Human-readable explanation.

EntityNotFound(EntityId)

A referenced entity does not exist.

StopNotFound(StopId)

A referenced stop ID does not exist in the config.

GroupNotFound(GroupId)

A referenced group does not exist.

RouteOriginMismatch

The route’s origin does not match the expected origin.

Fields

expected_origin: EntityId

The expected origin entity.

route_origin: EntityId

The origin recorded in the route.

LineDoesNotServeStop

An elevator’s line does not serve the target stop.

Fields

line_or_car: EntityId

The elevator (or line) entity.

stop: EntityId

The stop that is not served.

HallCallNotFound

No hall call exists at the given stop and direction.

Fields

stop: EntityId

The stop entity.

direction: CallDirection

The call direction.

WrongRiderPhase

A rider is in the wrong lifecycle phase for the attempted operation.

Fields

rider: EntityId

The rider entity.

expected: RiderPhaseKind

The phase required by the operation.

actual: RiderPhaseKind

The rider’s current phase.

RiderHasNoStop(EntityId)

A rider has no current stop when one is required.

EmptyRoute

A route has no legs.

NotAnElevator(EntityId)

The entity is not an elevator.

ElevatorDisabled(EntityId)

The elevator is disabled.

WrongServiceMode

The elevator is in an incompatible service mode.

Fields

entity: EntityId

The elevator entity.

expected: ServiceMode

The service mode required by the operation.

actual: ServiceMode

The elevator’s current service mode.

NotAStop(EntityId)

The entity is not a stop.

LineNotFound(EntityId)

A line entity was not found.

NoRoute

No route exists between origin and destination across any group.

Fields

origin: EntityId

The origin stop.

destination: EntityId

The destination stop.

origin_groups: Vec<GroupId>

Groups that serve the origin (if any).

destination_groups: Vec<GroupId>

Groups that serve the destination (if any).

AmbiguousRoute

Multiple groups serve both origin and destination — caller must specify.

Fields

origin: EntityId

The origin stop.

destination: EntityId

The destination stop.

groups: Vec<GroupId>

The groups that serve both stops.

SnapshotVersion

Snapshot bytes were produced by a different crate version.

Fields

saved: String

Crate version recorded in the snapshot header.

current: String

Current crate version attempting the restore.

SnapshotFormat(String)

Snapshot bytes are malformed or not a snapshot at all.

Trait Implementations

impl Clone for SimError

fn clone(&self) -> SimError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SimError

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

Formats the value using the given formatter.

impl Display for SimError

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

Formats the value using the given formatter.

impl Error for SimError

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.

impl From<EntityId> for SimError

fn from(id: EntityId) -> Self

Converts to this type from the input type.

impl From<GroupId> for SimError

fn from(id: GroupId) -> Self

Converts to this type from the input type.

impl From<StopId> for SimError

fn from(id: StopId) -> Self

Converts to this type from the input type.

impl PartialEq for SimError

fn eq(&self, other: &SimError) -> 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 Eq for SimError

impl StructuralPartialEq for SimError