Trait Unaligned 

pub unsafe trait Unaligned { }

Types with no alignment requirement.

If T: Unaligned, then align_of::<T>() == 1.

Implementation

Do not implement this trait yourself! Instead, use #[derive(Unaligned)]; e.g.:

#[derive(Unaligned)]
#[repr(C)]
struct MyStruct {
    ...
}

#[derive(Unaligned)]
#[repr(u8)]
enum MyEnum {
    ...
}

#[derive(Unaligned)]
#[repr(packed)]
union MyUnion {
    ...
}

This derive performs a sophisticated, compile-time safety analysis to determine whether a type is Unaligned.

Safety

This section describes what is required in order for T: Unaligned, and what unsafe code may assume of such types. If you don’t plan on implementing Unaligned manually, and you don’t plan on writing unsafe code that operates on Unaligned types, then you don’t need to read this section.

If T: Unaligned, then unsafe code may assume that it is sound to produce a reference to T at any memory location regardless of alignment. If a type is marked as Unaligned which violates this contract, it may cause undefined behavior.

#[derive(Unaligned)] only permits types which satisfy these requirements.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl Unaligned for ()

impl Unaligned for AtomicBool

Available on rust=1.60.0 and target_has_atomic=8 only.

impl Unaligned for AtomicI8

Available on rust=1.60.0 and target_has_atomic=8 only.

impl Unaligned for AtomicU8

Available on rust=1.60.0 and target_has_atomic=8 only.

impl Unaligned for NonZeroI8

impl Unaligned for NonZeroU8

impl Unaligned for Option<NonZeroI8>

impl Unaligned for Option<NonZeroU8>

impl Unaligned for bool

impl Unaligned for i8

impl Unaligned for str

impl Unaligned for u8

impl<T: ?Sized + Unaligned> Unaligned for Cell<T>

impl<T: ?Sized + Unaligned> Unaligned for ManuallyDrop<T>

impl<T: ?Sized + Unaligned> Unaligned for UnsafeCell<T>

impl<T: ?Sized> Unaligned for PhantomData<T>

impl<T: Unaligned, const N: usize> Unaligned for [T; N]

impl<T: Unaligned> Unaligned for CoreMaybeUninit<T>

impl<T: Unaligned> Unaligned for Wrapping<T>

impl<T: Unaligned> Unaligned for [T]

Implementors

impl<O> Unaligned for F32<O>

where [u8; 4]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for F64<O>

where [u8; 8]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for I16<O>

where [u8; 2]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for I32<O>

where [u8; 4]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for I64<O>

where [u8; 8]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for I128<O>

where [u8; 16]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for Isize<O>

where [u8; 4]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for U16<O>

where [u8; 2]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for U32<O>

where [u8; 4]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for U64<O>

where [u8; 8]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for U128<O>

where [u8; 16]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<O> Unaligned for Usize<O>

where [u8; 4]: Unaligned, PhantomData<O>: Unaligned,

Available on crate features derive only.

impl<T: ?Sized + Unaligned> Unaligned for ReadOnly<T>

impl<T> Unaligned for Unalign<T>

Available on crate features derive only.