Struct ContextV7

pub struct ContextV7 { /* private fields */ }

An unsynchronized, reseeding counter that produces 42-bit values.

This type works by:

1. Reseeding the counter each millisecond with a random 41-bit value. The 42nd bit is left unset so the counter can safely increment over the millisecond.
2. Wrapping the counter back to zero if it overflows its 42-bit storage and adding a millisecond to the timestamp.

This type can be used when constructing version 7 UUIDs. When used to construct a version 7 UUID, the 42-bit counter will be padded with random data. This type can be used to maintain ordering of UUIDs within the same millisecond.

This type should not be used when constructing version 1 or version 6 UUIDs. When used to construct a version 1 or version 6 UUID, only the 14 least significant bits of the counter will be used.

Implementations

impl ContextV7

pub const fn new() -> Self

Construct a new context that will reseed its counter on the first non-zero timestamp it receives.

Trait Implementations

impl ClockSequence for ContextV7

type Output = u64

The type of sequence returned by this counter.

fn generate_sequence(&self, seconds: u64, subsec_nanos: u32) -> Self::Output

Get the next value in the sequence to feed into a timestamp.

fn generate_timestamp_sequence( &self, seconds: u64, subsec_nanos: u32, ) -> (Self::Output, u64, u32)

Get the next value in the sequence, potentially also adjusting the timestamp.

fn usable_bits(&self) -> usize

The number of usable bits from the least significant bit in the result of ClockSequence::generate_sequence or ClockSequence::generate_timestamp_sequence.

impl Debug for ContextV7

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

Formats the value using the given formatter.

impl RefUnwindSafe for ContextV7