Struct Unaligned

#[repr(packed(1))]
pub struct Unaligned<T: LmdbRawIfUnaligned>(/* private fields */);

Wrapper for arbitrary Copy types which lifts their alignment restrictions.

This allows using values which have non-byte alignment but are otherwise LMDB-safe (as defined by LmdbRaw) to be used with it. It obviously does not make T itself packed, so the same discussion with respect to padding in the LmdbRaw documentation applies here as well.

There is no way to get a reference to the contained value, as Rust currently has no way to express that the reference may be misaligned. (See also https://github.com/rust-lang/rust/issues/27060.)

Example

use lmdb_zero as lmdb;
use lmdb_zero::Unaligned as U;

fn get_a_u64(env: &lmdb::Environment, db: &lmdb::Database,
             key: &str) -> u64 {
  let tx = lmdb::ReadTransaction::new(env).unwrap();
  let access = tx.access();
  access.get::<str, U<u64>>(db, key).unwrap().get()
}

Implementations

impl<T: LmdbRawIfUnaligned> Unaligned<T>

pub fn new(t: T) -> Self

Wraps t in an Unaligned marker.

pub fn of_ref(t: &T) -> &Self

Returns t as if it were wrapped by Unaligned.

This is safe because any &T is a valid &Unaligned<T>.

pub fn of_mut(t: &mut T) -> &mut Self

Returns t as if it were wrapped by Unaligned.

This is safe because any &T is a valid &Unaligned<T>.

pub fn get(&self) -> T

Extracts the contained value.

This is safe as the compiler has visibility into the fact that the contained value is misaligned and can copy appropriately.

pub fn set(&mut self, t: T)

Replaces the contained value.

Trait Implementations

impl<T: LmdbRawIfUnaligned + Add<T>> Add for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as Add>::Output>

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl<T: LmdbRawIfUnaligned + AddAssign<T>> AddAssign for Unaligned<T>

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl<T> Binary for Unaligned<T>

where T: Binary + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T: LmdbRawIfUnaligned + BitAnd<T>> BitAnd for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as BitAnd>::Output>

The resulting type after applying the & operator.

fn bitand(self, rhs: Self) -> Self::Output

Performs the & operation.

impl<T: LmdbRawIfUnaligned + BitAndAssign<T>> BitAndAssign for Unaligned<T>

fn bitand_assign(&mut self, rhs: Self)

Performs the &= operation.

impl<T: LmdbRawIfUnaligned + BitOr<T>> BitOr for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as BitOr>::Output>

The resulting type after applying the | operator.

fn bitor(self, rhs: Self) -> Self::Output

Performs the | operation.

impl<T: LmdbRawIfUnaligned + BitOrAssign<T>> BitOrAssign for Unaligned<T>

fn bitor_assign(&mut self, rhs: Self)

Performs the |= operation.

impl<T: LmdbRawIfUnaligned + BitXor<T>> BitXor for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as BitXor>::Output>

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: Self) -> Self::Output

Performs the ^ operation.

impl<T: LmdbRawIfUnaligned + BitXorAssign<T>> BitXorAssign for Unaligned<T>

fn bitxor_assign(&mut self, rhs: Self)

Performs the ^= operation.

impl<T: LmdbRawIfUnaligned> Clone for Unaligned<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 Unaligned<T>

where T: Debug + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T> Display for Unaligned<T>

where T: Display + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T: LmdbRawIfUnaligned + Div<T>> Div for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as Div>::Output>

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self::Output

Performs the / operation.

impl<T: LmdbRawIfUnaligned + DivAssign<T>> DivAssign for Unaligned<T>

fn div_assign(&mut self, rhs: Self)

Performs the /= operation.

impl<T: LmdbRawIfUnaligned + Hash> Hash for Unaligned<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: LmdbRawIfUnaligned + LmdbOrdKeyIfUnaligned> LmdbOrdKey for Unaligned<T>

fn ordered_by_bytes() -> bool

Returns whether the default LMDB byte-by-byte comparison is correct for valid values of this type.

fn ordered_as_integer() -> bool

Returns whether LMDB will correctly handle this value with the INTEGERKEY or INTEGERDUP flags.

impl<T: LmdbRawIfUnaligned> LmdbRaw for Unaligned<T>

fn reported_type() -> String

Returns the name of this type to report in error messages.

impl<T> LowerExp for Unaligned<T>

where T: LowerExp + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T> LowerHex for Unaligned<T>

where T: LowerHex + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T: LmdbRawIfUnaligned + Mul<T>> Mul for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as Mul>::Output>

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self::Output

Performs the * operation.

impl<T: LmdbRawIfUnaligned + MulAssign<T>> MulAssign for Unaligned<T>

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl<T> Octal for Unaligned<T>

where T: Octal + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T: LmdbRawIfUnaligned + Ord> Ord for Unaligned<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: LmdbRawIfUnaligned + PartialEq<T>> PartialEq for Unaligned<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: LmdbRawIfUnaligned + PartialOrd<T>> PartialOrd for Unaligned<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: &Self) -> bool

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

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

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

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

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

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

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

impl<T> Pointer for Unaligned<T>

where T: Pointer + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T: LmdbRawIfUnaligned + Rem<T>> Rem for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as Rem>::Output>

The resulting type after applying the % operator.

fn rem(self, rhs: Self) -> Self::Output

Performs the % operation.

impl<T: LmdbRawIfUnaligned + RemAssign<T>> RemAssign for Unaligned<T>

fn rem_assign(&mut self, rhs: Self)

Performs the %= operation.

impl<T: LmdbRawIfUnaligned + Shl<T>> Shl for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as Shl>::Output>

The resulting type after applying the << operator.

fn shl(self, rhs: Self) -> Self::Output

Performs the << operation.

impl<T: LmdbRawIfUnaligned + ShlAssign<T>> ShlAssign for Unaligned<T>

fn shl_assign(&mut self, rhs: Self)

Performs the <<= operation.

impl<T: LmdbRawIfUnaligned + Shr<T>> Shr for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as Shr>::Output>

The resulting type after applying the >> operator.

fn shr(self, rhs: Self) -> Self::Output

Performs the >> operation.

impl<T: LmdbRawIfUnaligned + ShrAssign<T>> ShrAssign for Unaligned<T>

fn shr_assign(&mut self, rhs: Self)

Performs the >>= operation.

impl<T: LmdbRawIfUnaligned + Sub<T>> Sub for Unaligned<T>

where T::Output: LmdbRawIfUnaligned,

type Output = Unaligned<<T as Sub>::Output>

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl<T: LmdbRawIfUnaligned + SubAssign<T>> SubAssign for Unaligned<T>

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl<T> UpperExp for Unaligned<T>

where T: UpperExp + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T> UpperHex for Unaligned<T>

where T: UpperHex + LmdbRawIfUnaligned,

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

Formats the value using the given formatter.

impl<T: LmdbRawIfUnaligned> Copy for Unaligned<T>

impl<T: LmdbRawIfUnaligned + Eq> Eq for Unaligned<T>