Enum DiceError 

pub enum DiceError {
    Overflow(String),
    InvalidSpec(RollSpec, String),
    ParseError {
        kind: ParseErrorKind,
        input: String,
        start: usize,
        stop: Option<usize>,
    },
    SyntaxError {
        input: String,
        start: usize,
        stop: Option<usize>,
        expected: Option<String>,
    },
    TrailingInput {
        input: String,
        pos: usize,
    },
}

Errors that can occur when parsing or evaluating dice expressions.

This enum covers all possible error conditions, including parse errors, invalid roll specifications, and arithmetic overflow.

Variants

• Overflow: Integer overflow during calculation
• InvalidSpec: Invalid roll specification (e.g., trying to keep more dice than rolled)
• ParseError: Error parsing the input string
• SyntaxError: Syntax error in the dice expression
• TrailingInput: Unexpected characters after the expression

Examples

use dice_parser::DiceExpr;

// Parse error - invalid syntax
let err = DiceExpr::parse("2d").unwrap_err();

// Syntax error - negative dice count
let err = DiceExpr::parse("-2d6").unwrap_err();

// Trailing input error
let err = DiceExpr::parse("2d6 extra").unwrap_err();

Variants

Overflow(String)

Integer overflow occurred during calculation.

InvalidSpec(RollSpec, String)

Invalid roll specification.

This error occurs when a RollSpec is invalid, such as trying to keep more dice than were rolled.

ParseError

Parse error with details about what went wrong.

Fields

kind: ParseErrorKind

The kind of parse error.

input: String

The input string that failed to parse.

start: usize

The byte position where the error started.

stop: Option<usize>

The byte position where the error ended (if applicable).

SyntaxError

Syntax error in the dice expression.

Fields

input: String

The input string with the syntax error.

start: usize

The byte position where the error started.

stop: Option<usize>

The byte position where the error ended (if applicable).

expected: Option<String>

Description of what was expected.

TrailingInput

Unexpected characters found after the expression.

Fields

input: String

The input string with trailing characters.

pos: usize

The byte position where trailing input begins.

Trait Implementations

impl Clone for DiceError

fn clone(&self) -> DiceError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiceError

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

Formats the value using the given formatter.

impl Display for DiceError

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

Formats the value using the given formatter.

impl Error for DiceError

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<TryFromIntError> for DiceError

fn from(value: TryFromIntError) -> Self

Converts to this type from the input type.