Struct Fuid 

#[repr(transparent)]
pub struct Fuid<H>(pub u64_be, _);

• 64bit id [–timestamp(40)–|–shard_id(8)–|–seq_id(16)–]
• 40 bit - timestamp (in milliseconds) started from 2023-04-09 0:00:00 UTC, 34 years available (from 2023 to 2057)
• 8 bit - shard_id ([datacenter_id / instance_id] with thread_id), 256 values
• 16 bit - random sequence id (unique for thread / per thread), 65_536 values
• Blowfish for encryption
• ZBASE32 for encoding into 13 length string (example: “ifs1gp9dw8hdw”)
• create ~ 50ns (~ 21k in 1ms or 21m in 1s) in 1 thread

Notes:

• checks timestamp and shard_id when deserialized from string
• Fuid is not inlined for InlineArray

Tuple Fields

0: u64_be

Implementations

impl<H> Fuid<H>

pub fn from_thread() -> Self

pub fn with_inst_thread(instance_id: u64, thread_id: u64) -> Self

• 3 bit - instance id (datacenter id / shard id) (max 7)
• 5 bit - thread id (max 31)
• instance_id (datacenter) < 8 and thread_id (worker) < 32

pub fn with_shard(shard_id: u64) -> Self

Create a new Fuid.

• shard_id < 256

pub fn timestamp(&self) -> u64

unix timestamp in milliseconds

pub fn date(&self) -> OffsetDateTime

pub fn get(&self) -> u64

get LE u64

pub fn to_be_bytes(self) -> [u8; 8]

pub fn from_be_bytes(bytes: [u8; 8]) -> Self

pub fn to_bytes(self) -> [u8; 8]

to BE bytes

pub fn from_bytes(bytes: [u8; 8]) -> Self

from BE bytes

pub fn to_u64(self) -> u64

to BE u64

pub fn from_u64(bytes: u64) -> Self

from BE u64

pub fn to_le_bytes(self) -> [u8; 8]

pub fn instance_id(&self) -> u64

pub fn thread_id(&self) -> u64

pub fn shard_id(&self) -> u64

pub fn format<W>(&self, w: &mut W) -> Result<(), Error>

where W: Write,

id: {id:#x}; {id:#b}; {dt}-{instance_id}-{thread_id}-{seq}

pub fn date_prefix(ms: u64) -> [u8; 8]

return prefix for date [–timestamp(5)–|0x00(1)|0x0000(2)] ms - unix timestamp in milliseconds

pub fn check(&self) -> Result<(), ArmourError>

pub fn increment(self) -> Self

only for iterator with excluded bounds

pub fn group_id(&self) -> u32

group_id for this Fuid (12 days one group)

impl<H: IdHasher> Fuid<H>

pub fn ser(self) -> IdStr

pub fn deser(id: &str) -> Result<Self, ArmourError>

impl Fuid<()>

pub fn ser(self) -> IdStr

pub fn deser(id: &str) -> Result<Self, ArmourError>

Trait Implementations

impl<T> AsRef<[u8; 8]> for Fuid<T>

fn as_ref(&self) -> &[u8; 8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<T> AsRef<Fuid<T>> for Fuid<T>

fn as_ref(&self) -> &Self

Converts this type into a shared reference of the (usually inferred) input type.

impl<T> Clone for Fuid<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<H> Debug for Fuid<H>

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Fuid<()>

Available on crate feature std only.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'de, T: IdHasher> Deserialize<'de> for Fuid<T>

Available on crate feature std only.

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Fuid<()>

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

Formats the value using the given formatter.

impl<H: IdHasher> Display for Fuid<H>

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

Formats the value using the given formatter.

impl<H> From<Fuid<H>> for OptFuid<H>

fn from(id: Fuid<H>) -> Self

Converts to this type from the input type.

impl<H> FromBytes for Fuid<H>

where u64_be: FromBytes, PhantomData<H>: FromBytes,

fn ref_from_bytes( source: &[u8], ) -> Result<&Self, ConvertError<AlignmentError<&[u8], Self>, SizeError<&[u8], Self>, Infallible>>

where Self: KnownLayout + Immutable,

Interprets the given source as a &Self.

fn ref_from_prefix( source: &[u8], ) -> Result<(&Self, &[u8]), ConvertError<AlignmentError<&[u8], Self>, SizeError<&[u8], Self>, Infallible>>

where Self: KnownLayout + Immutable,

Interprets the prefix of the given source as a &Self without copying.

fn ref_from_suffix( source: &[u8], ) -> Result<(&[u8], &Self), ConvertError<AlignmentError<&[u8], Self>, SizeError<&[u8], Self>, Infallible>>

where Self: Immutable + KnownLayout,

Interprets the suffix of the given bytes as a &Self.

fn mut_from_bytes( source: &mut [u8], ) -> Result<&mut Self, ConvertError<AlignmentError<&mut [u8], Self>, SizeError<&mut [u8], Self>, Infallible>>

where Self: IntoBytes + KnownLayout,

Interprets the given source as a &mut Self.

fn mut_from_prefix( source: &mut [u8], ) -> Result<(&mut Self, &mut [u8]), ConvertError<AlignmentError<&mut [u8], Self>, SizeError<&mut [u8], Self>, Infallible>>

where Self: IntoBytes + KnownLayout,

Interprets the prefix of the given source as a &mut Self without copying.

fn mut_from_suffix( source: &mut [u8], ) -> Result<(&mut [u8], &mut Self), ConvertError<AlignmentError<&mut [u8], Self>, SizeError<&mut [u8], Self>, Infallible>>

where Self: IntoBytes + KnownLayout,

Interprets the suffix of the given source as a &mut Self without copying.

fn read_from_bytes(source: &[u8]) -> Result<Self, SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the given source.

fn read_from_prefix( source: &[u8], ) -> Result<(Self, &[u8]), SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the prefix of the given source.

fn read_from_suffix( source: &[u8], ) -> Result<(&[u8], Self), SizeError<&[u8], Self>>

where Self: Sized,

Reads a copy of Self from the suffix of the given source.

impl FromStr for Fuid<()>

type Err = ArmourError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, ArmourError>

Parses a string s to return a value of this type.

impl<T: IdHasher> FromStr for Fuid<T>

type Err = ArmourError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, ArmourError>

Parses a string s to return a value of this type.

impl<H> FromZeros for Fuid<H>

where u64_be: FromZeros, PhantomData<H>: FromZeros,

fn zero(&mut self)

Overwrites self with zeros.

fn new_zeroed() -> Self

where Self: Sized,

Creates an instance of Self from zeroed bytes.

impl<H> GetType for Fuid<H>

const TYPE: Typ = Typ::Fuid

impl<H: Hash> Hash for Fuid<H>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<H> IntoBytes for Fuid<H>

where u64_be: IntoBytes, PhantomData<H>: IntoBytes,

fn as_bytes(&self) -> &[u8]

where Self: Immutable,

Gets the bytes of this value.

fn as_mut_bytes(&mut self) -> &mut [u8]

where Self: FromBytes,

Gets the bytes of this value mutably.

fn write_to(&self, dst: &mut [u8]) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to dst.

fn write_to_prefix( &self, dst: &mut [u8], ) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to the prefix of dst.

fn write_to_suffix( &self, dst: &mut [u8], ) -> Result<(), SizeError<&Self, &mut [u8]>>

where Self: Immutable,

Writes a copy of self to the suffix of dst.

impl<H> KeyPart for Fuid<H>

const TY: KeyType = KeyType::Fuid

const PREFIX_BITS: u32 = MILLISECOND_BITS

impl<H> KnownLayout for Fuid<H>

where Self: Sized,

type PointerMetadata = ()

The type of metadata stored in a pointer to Self.

fn size_for_metadata(meta: Self::PointerMetadata) -> Option<usize>

Computes the size of an object of type Self with the given pointer metadata.

impl<T> Ord for Fuid<T>

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T> PartialEq<[u8; 8]> for Fuid<T>

fn eq(&self, other: &[u8; 8]) -> 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<T> PartialEq<Fuid<T>> for [u8; 8]

fn eq(&self, other: &Fuid<T>) -> 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<T> PartialEq<Fuid<T>> for OptFuid<T>

fn eq(&self, other: &Fuid<T>) -> 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<T> PartialEq<Fuid<T>> for Option<Fuid<T>>

fn eq(&self, other: &Fuid<T>) -> 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<T> PartialEq<OptFuid<T>> for Fuid<T>

fn eq(&self, other: &OptFuid<T>) -> 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<T> PartialEq<Option<Fuid<T>>> for Fuid<T>

fn eq(&self, other: &Option<Fuid<T>>) -> 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<T> PartialEq for Fuid<T>

fn eq(&self, other: &Self) -> 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<T> PartialOrd for Fuid<T>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Rapira for Fuid<()>

const STATIC_SIZE: Option<usize>

const MIN_SIZE: usize = 8

fn size(&self) -> usize

size of bytes for serialize

fn check_bytes(slice: &mut &[u8]) -> Result<()>

check bytes, collections len, check utf-8, NonZero, f32 and others…

fn from_slice(slice: &mut &[u8]) -> Result<Self>

where Self: Sized,

this is safe, but not check collections capacity! recommend use only for safe data (example: from DB), not external data.

fn convert_to_bytes(&self, slice: &mut [u8], cursor: &mut usize)

fn debug_from_slice(slice: &mut &[u8]) -> Result<Self, RapiraError>

where Self: Sized + Debug,

unsafe fn from_slice_unchecked(slice: &mut &[u8]) -> Result<Self, RapiraError>

where Self: Sized,

Safety

unsafe fn from_slice_unsafe(slice: &mut &[u8]) -> Result<Self, RapiraError>

where Self: Sized,

Safety

fn from_slice_versioned( slice: &mut &[u8], _version: u8, ) -> Result<Self, RapiraError>

where Self: Sized,

Deserialize with schema version awareness.

fn try_convert_to_bytes( &self, slice: &mut [u8], cursor: &mut usize, ) -> Result<(), RapiraError>

fn convert_to_bytes_ctx( &self, slice: &mut [u8], cursor: &mut usize, _flags: RapiraFlags, )

Context-aware serialization. Default: delegates to convert_to_bytes.

fn from_slice_ctx( slice: &mut &[u8], _flags: RapiraFlags, ) -> Result<Self, RapiraError>

where Self: Sized,

Context-aware deserialization. Default: delegates to from_slice.

fn size_ctx(&self, _flags: RapiraFlags) -> usize

Context-aware size calculation. Default: delegates to size.

impl<H: IdHasher> Rapira for Fuid<H>

only check if non-zero, not check valid byte mask

const STATIC_SIZE: Option<usize>

const MIN_SIZE: usize = 8

fn size(&self) -> usize

size of bytes for serialize

fn check_bytes(slice: &mut &[u8]) -> Result<()>

check bytes, collections len, check utf-8, NonZero, f32 and others…

fn from_slice(slice: &mut &[u8]) -> Result<Self>

where Self: Sized,

this is safe, but not check collections capacity! recommend use only for safe data (example: from DB), not external data.

fn convert_to_bytes(&self, slice: &mut [u8], cursor: &mut usize)

fn convert_to_bytes_ctx( &self, slice: &mut [u8], cursor: &mut usize, flags: RapiraFlags, )

Context-aware serialization. Default: delegates to convert_to_bytes.

fn from_slice_ctx(slice: &mut &[u8], flags: RapiraFlags) -> Result<Self>

where Self: Sized,

Context-aware deserialization. Default: delegates to from_slice.

fn debug_from_slice(slice: &mut &[u8]) -> Result<Self, RapiraError>

where Self: Sized + Debug,

unsafe fn from_slice_unchecked(slice: &mut &[u8]) -> Result<Self, RapiraError>

where Self: Sized,

Safety

unsafe fn from_slice_unsafe(slice: &mut &[u8]) -> Result<Self, RapiraError>

where Self: Sized,

Safety

fn from_slice_versioned( slice: &mut &[u8], _version: u8, ) -> Result<Self, RapiraError>

where Self: Sized,

Deserialize with schema version awareness.

fn try_convert_to_bytes( &self, slice: &mut [u8], cursor: &mut usize, ) -> Result<(), RapiraError>

fn size_ctx(&self, _flags: RapiraFlags) -> usize

Context-aware size calculation. Default: delegates to size.

impl Serialize for Fuid<()>

Available on crate feature std only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<T: IdHasher> Serialize for Fuid<T>

Available on crate feature std only.

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl<H> TransparentWrapper<u64_be> for Fuid<H>

fn wrap(s: Inner) -> Self

where Self: Sized,

Convert the inner type into the wrapper type.

fn wrap_ref(s: &Inner) -> &Self

Convert a reference to the inner type into a reference to the wrapper type.

fn wrap_mut(s: &mut Inner) -> &mut Self

Convert a mutable reference to the inner type into a mutable reference to the wrapper type.

fn wrap_slice(s: &[Inner]) -> &[Self]

where Self: Sized,

Convert a slice to the inner type into a slice to the wrapper type.

fn wrap_slice_mut(s: &mut [Inner]) -> &mut [Self]

where Self: Sized,

Convert a mutable slice to the inner type into a mutable slice to the wrapper type.

fn peel(s: Self) -> Inner

where Self: Sized,

Convert the wrapper type into the inner type.

fn peel_ref(s: &Self) -> &Inner

Convert a reference to the wrapper type into a reference to the inner type.

fn peel_mut(s: &mut Self) -> &mut Inner

Convert a mutable reference to the wrapper type into a mutable reference to the inner type.

fn peel_slice(s: &[Self]) -> &[Inner]

where Self: Sized,

Convert a slice to the wrapped type into a slice to the inner type.

fn peel_slice_mut(s: &mut [Self]) -> &mut [Inner]

where Self: Sized,

Convert a mutable slice to the wrapped type into a mutable slice to the inner type.

impl TryFrom<&str> for Fuid<()>

type Error = ArmourError

The type returned in the event of a conversion error.

fn try_from(val: &str) -> Result<Self, ArmourError>

Performs the conversion.

impl<T: IdHasher> TryFrom<&str> for Fuid<T>

type Error = ArmourError

The type returned in the event of a conversion error.

fn try_from(val: &str) -> Result<Self, ArmourError>

Performs the conversion.

impl<H> TryFromBytes for Fuid<H>

where u64_be: TryFromBytes, PhantomData<H>: TryFromBytes,

fn try_ref_from_bytes( source: &[u8], ) -> Result<&Self, ConvertError<AlignmentError<&[u8], Self>, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: KnownLayout + Immutable,

Attempts to interpret the given source as a &Self.

fn try_ref_from_prefix( source: &[u8], ) -> Result<(&Self, &[u8]), ConvertError<AlignmentError<&[u8], Self>, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: KnownLayout + Immutable,

Attempts to interpret the prefix of the given source as a &Self.

fn try_ref_from_suffix( source: &[u8], ) -> Result<(&[u8], &Self), ConvertError<AlignmentError<&[u8], Self>, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: KnownLayout + Immutable,

Attempts to interpret the suffix of the given source as a &Self.

fn try_mut_from_bytes( bytes: &mut [u8], ) -> Result<&mut Self, ConvertError<AlignmentError<&mut [u8], Self>, SizeError<&mut [u8], Self>, ValidityError<&mut [u8], Self>>>

where Self: KnownLayout + IntoBytes,

Attempts to interpret the given source as a &mut Self without copying.

fn try_mut_from_prefix( source: &mut [u8], ) -> Result<(&mut Self, &mut [u8]), ConvertError<AlignmentError<&mut [u8], Self>, SizeError<&mut [u8], Self>, ValidityError<&mut [u8], Self>>>

where Self: KnownLayout + IntoBytes,

Attempts to interpret the prefix of the given source as a &mut Self.

fn try_mut_from_suffix( source: &mut [u8], ) -> Result<(&mut [u8], &mut Self), ConvertError<AlignmentError<&mut [u8], Self>, SizeError<&mut [u8], Self>, ValidityError<&mut [u8], Self>>>

where Self: KnownLayout + IntoBytes,

Attempts to interpret the suffix of the given source as a &mut Self.

fn try_read_from_bytes( source: &[u8], ) -> Result<Self, ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read the given source as a Self.

fn try_read_from_prefix( source: &[u8], ) -> Result<(Self, &[u8]), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read a Self from the prefix of the given source.

fn try_read_from_suffix( source: &[u8], ) -> Result<(&[u8], Self), ConvertError<Infallible, SizeError<&[u8], Self>, ValidityError<&[u8], Self>>>

where Self: Sized,

Attempts to read a Self from the suffix of the given source.

impl<T> Zeroable for Fuid<T>

fn zeroed() -> Self

Calls zeroed.

impl<T> Copy for Fuid<T>

impl<T> Eq for Fuid<T>

impl<H> Immutable for Fuid<H>

where u64_be: Immutable, PhantomData<H>: Immutable,

impl<T: 'static> Pod for Fuid<T>