Struct OptId64 

pub struct OptId64<T>(/* private fields */);

Optional 64-bit ID with the same 8-byte representation as Id64.

Zero ([0u8; 8]) is interpreted as None. Use in zerocopy-compatible structs where Option<Id64> would break alignment (16+ bytes).

#[derive(FromBytes, IntoBytes, Immutable, KnownLayout, Copy, Clone)]
#[repr(C)]
struct Follower {
    follow: Id64<H>,       // 8 bytes
    follower: OptId64<H>,  // 8 bytes, zero = None
}

Implementations

impl<T> OptId64<T>

pub const NONE: Self

pub fn some(id: Id64<T>) -> Self

pub fn get(self) -> Option<Id64<T>>

pub fn is_some(self) -> bool

pub fn is_none(self) -> bool

pub fn get_raw(self) -> u64

get LE u64 (0 for None)

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

to BE bytes

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

from BE bytes

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

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

Trait Implementations

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

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

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

impl<T> Clone for OptId64<T>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for OptId64<T>

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

Formats the value using the given formatter.

impl<T> Default for OptId64<T>

fn default() -> Self

Returns the “default value” for a type.

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

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 OptId64<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<T> From<Id64<T>> for OptId64<T>

fn from(id: Id64<T>) -> Self

Converts to this type from the input type.

impl<T> From<OptId64<T>> for Option<Id64<T>>

fn from(opt: OptId64<T>) -> Self

Converts to this type from the input type.

impl<T> From<Option<Id64<T>>> for OptId64<T>

fn from(opt: Option<Id64<T>>) -> Self

Converts to this type from the input type.

impl<T> FromBytes for OptId64<T>

where u64_be: FromBytes, PhantomData<T>: 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<T> FromZeros for OptId64<T>

where u64_be: FromZeros, PhantomData<T>: 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<T> GetType for OptId64<T>

const TYPE: Typ = Typ::Id64

impl<T> Hash for OptId64<T>

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<T> IntoBytes for OptId64<T>

where u64_be: IntoBytes, PhantomData<T>: 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<T> KnownLayout for OptId64<T>

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 OptId64<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<Id64<T>> for OptId64<T>

fn eq(&self, other: &Id64<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<OptId64<T>> for Id64<T>

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

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<(), RapiraError>

where Self: Sized,

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

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

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<T: IdHasher> Rapira for OptId64<T>

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<(), RapiraError>

where Self: Sized,

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

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

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, RapiraError>

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 OptId64<()>

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 OptId64<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<T> TransparentWrapper<u64_be> for OptId64<T>

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<T> TryFromBytes for OptId64<T>

where u64_be: TryFromBytes, PhantomData<T>: 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 OptId64<T>

fn zeroed() -> Self

Calls zeroed.

impl<T> Copy for OptId64<T>

impl<T> Eq for OptId64<T>

impl<T> Immutable for OptId64<T>

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

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