Enum SnowflakeError 

pub enum SnowflakeError {
    InvalidBitLayout {
        t: u8,
        m: u8,
        n: u8,
        s: u8,
        total: u8,
    },
    MachineIdOutOfRange {
        given: i64,
        max: i64,
    },
    NodeIdOutOfRange {
        given: i64,
        max: i64,
    },
    AlreadyInitialized,
    NodeIdExhausted {
        max: i64,
    },
    ClockMovedBackwards,
    ClockBeforeEpoch,
}

All errors that the snowflake crate can produce.

Variants

InvalidBitLayout

The bit widths of all four fields do not sum to 63.

An i64 has one sign bit, so the remaining 63 bits must be fully allocated to avoid negative IDs or wasted space.

Fields

t: u8

m: u8

n: u8

s: u8

total: u8

MachineIdOutOfRange

A machine_id was provided that exceeds the layout’s maximum.

Fields

given: i64

max: i64

NodeIdOutOfRange

A node_id was provided that exceeds the layout’s maximum.

Fields

given: i64

max: i64

AlreadyInitialized

The global generator has already been initialized.

init / init_with_epoch can only be called once per process. Re-initialization is rejected because existing thread-local generators would keep using the old configuration, leading to inconsistent ID layouts. To change the configuration, restart the process so that all thread-local state is cleared.

NodeIdExhausted

More threads have called next_id than the layout’s node_id_bits can accommodate.

With the default 5 node_id_bits, at most 32 threads (node IDs 0..=31) can generate IDs. If your application needs more threads, increase node_id_bits (and reduce machine_id_bits or timestamp_bits to compensate) when calling init.

Fields

max: i64

ClockMovedBackwards

The system clock moved backwards, which would break ID monotonicity.

ClockBeforeEpoch

The system clock is not available (e.g. time before epoch).

Trait Implementations

impl Clone for SnowflakeError

fn clone(&self) -> SnowflakeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SnowflakeError

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

Formats the value using the given formatter.

impl Display for SnowflakeError

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

Formats the value using the given formatter.

impl Error for SnowflakeError

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 SnowflakeError

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

impl StructuralPartialEq for SnowflakeError