Enum StoneError

pub enum StoneError {
    UnknownStone(StoneTemplateId),
    SlotHasNoSockets {
        item_type: ItemType,
    },
    WrongCollection {
        socket: StoneSocketSlot,
        expected: StoneKind,
        actual: StoneKind,
    },
    SocketLocked {
        item_type: ItemType,
        socket: StoneSocketSlot,
    },
    AlreadySocketed(StoneTemplateId),
    NotSocketed(StoneTemplateId),
    NotEnoughCopies {
        stone: StoneTemplateId,
        level: i64,
        required: i64,
        held: i64,
    },
    AlreadyMaxLevel(StoneTemplateId, i64),
    NoUpgradeStep(i64),
}

Why an insert/remove/upgrade was refused. Every variant is a rule from the design doc, so the caller can report the actual reason instead of a generic failure.

Variants

UnknownStone(StoneTemplateId)

SlotHasNoSockets

Fields

item_type: ItemType

WrongCollection

Fields

socket: StoneSocketSlot

expected: StoneKind

actual: StoneKind

SocketLocked

Fields

item_type: ItemType

socket: StoneSocketSlot

AlreadySocketed(StoneTemplateId)

One instance per template means one socket per template: this is also how “the same stone in two slots” is refused.

NotSocketed(StoneTemplateId)

NotEnoughCopies

Fields

stone: StoneTemplateId

level: i64

required: i64

held: i64

AlreadyMaxLevel(StoneTemplateId, i64)

NoUpgradeStep(i64)

The upgrade ladder has no rung for the level being bought. GameConfig::validate_stones rules this out at load time, so it means a config loaded past validation — refuse rather than guess a cost.

Trait Implementations

impl Debug for StoneError

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

Formats the value using the given formatter.

impl Display for StoneError

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

Formats the value using the given formatter.

impl Error for StoneError

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 PartialEq for StoneError

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

impl StructuralPartialEq for StoneError