Struct Flat 

pub struct Flat<T: ?Sized, B: Buffer> { /* private fields */ }

Inline-only storage for ?Sized types.

Stores a trait object (or slice) directly in a buffer of type B. The total struct size equals size_of::<B>().

• Sized T: full buffer capacity, value at offset 0.
• ?Sized T: one pointer-sized word reserved for metadata, value follows.

Use the flat! macro for ?Sized construction, or Flat::new for Sized types.

Compile-time safety

The ?Sized metadata overhead (one pointer-sized word) is validated at compile time for hand-implemented Buffer types. All predefined buffers (B16+) satisfy this constraint.

Implementations

impl<T: ?Sized, B: Buffer> Flat<T, B>

pub const fn capacity() -> usize

Returns the usable value capacity in bytes.

For Sized types, this is the full buffer. For ?Sized types, one pointer-sized word is reserved for metadata (vtable or slice length).

impl<T, B: Buffer> Flat<T, B>

pub fn new(val: T) -> Self

Constructs a Flat from a Sized value.

The value is stored at offset 0 with full buffer capacity.

Panics

• If size_of::<T>() exceeds B::CAPACITY.
• If align_of::<T>() exceeds align_of::<usize>().

Examples

use nexus_smartptr::{Flat, B32};

let f: Flat<u64, B32> = Flat::new(42);
assert_eq!(*f, 42);

Trait Implementations

impl<T: ?Sized, B: Buffer> Deref for Flat<T, B>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &T

Dereferences the value.

impl<T: ?Sized, B: Buffer> DerefMut for Flat<T, B>

fn deref_mut(&mut self) -> &mut T

Mutably dereferences the value.

impl<T: ?Sized, B: Buffer> Drop for Flat<T, B>

fn drop(&mut self)

Executes the destructor for this type.

impl<T: ?Sized + Send, B: Buffer> Send for Flat<T, B>

impl<T: ?Sized + Sync, B: Buffer> Sync for Flat<T, B>