Enum IdError 

pub enum IdError {
    HostOutOfRange {
        host: u64,
        max: u64,
    },
    NodeOutOfRange {
        node_id: u64,
        max: u64,
    },
    MachineIdOutOfRange {
        machine_id: u64,
        max: u64,
    },
    TimestampOverflow {
        timestamp: u64,
        max: u64,
    },
    SequenceOverflow {
        sequence: u64,
        max: u64,
    },
    ClockMovedBackwards {
        last_timestamp: u64,
        current_timestamp: u64,
        skew_millis: u64,
        max_skew_millis: u64,
    },
    TimeBeforeEpoch,
    StartTimeAhead,
    InvalidBitLength {
        name: &'static str,
        bits: u8,
        reason: &'static str,
    },
    InvalidTimeUnit {
        nanos: u128,
        min_nanos: u128,
    },
    RandomSourceUnavailable,
    StatePoisoned,
}

Error returned when an ID generator cannot create or compose an ID.

Variants

HostOutOfRange

A Qubit snowflake host identifier is outside its bit range.

Fields

host: u64

Provided host identifier.

max: u64

Maximum valid host identifier.

NodeOutOfRange

A classic snowflake node identifier is outside its bit range.

Fields

node_id: u64

Provided node identifier.

max: u64

Maximum valid node identifier.

MachineIdOutOfRange

A Sonyflake machine identifier is outside its bit range.

Fields

machine_id: u64

Provided machine identifier.

max: u64

Maximum valid machine identifier.

TimestampOverflow

A timestamp or elapsed time is too large for the configured bit layout.

Fields

timestamp: u64

Provided timestamp or elapsed time.

max: u64

Maximum representable timestamp or elapsed time.

SequenceOverflow

A sequence number is too large for the configured bit layout.

Fields

sequence: u64

Provided sequence number.

max: u64

Maximum representable sequence number.

ClockMovedBackwards

The observed clock moved backwards beyond the configured tolerance.

Fields

last_timestamp: u64

Last timestamp seen by the generator.

current_timestamp: u64

Current timestamp reported by the clock.

skew_millis: u64

Backwards skew in milliseconds.

max_skew_millis: u64

Maximum tolerated backwards skew in milliseconds.

TimeBeforeEpoch

The requested time is before the configured epoch.

StartTimeAhead

The configured Sonyflake start time is ahead of the generator clock.

InvalidBitLength

A Sonyflake bit length setting is invalid.

Fields

name: &'static str

Name of the invalid bit field.

bits: u8

Provided bit length.

reason: &'static str

Human-readable constraint for the field.

InvalidTimeUnit

A Sonyflake time unit is invalid.

Fields

nanos: u128

Provided time unit in nanoseconds.

min_nanos: u128

Minimum allowed time unit in nanoseconds.

RandomSourceUnavailable

The operating system random source could not provide random ID bytes.

StatePoisoned

The generator state mutex was poisoned by a panic while locked.

Trait Implementations

impl Clone for IdError

fn clone(&self) -> IdError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IdError

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

Formats the value using the given formatter.

impl Display for IdError

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

Formats the error with enough context for diagnostics.

impl Error for IdError

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 IdError

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

impl StructuralPartialEq for IdError