Struct Alloc64 

pub struct Alloc64;

Alloc64

Global, zero-sized allocator that enforces 64-bit alignment.

Behaviour

Hooks into Vec64. Behind the scenes, Vec64<T, Vec64>:

• Calls Vec64::allocate() when allocating new memory.
• Calls Vec64::grow() when reallocation is needed.
• Calls Vec64::deallocate() when the vector is dropped. etc, ensuring these calls go through the alignment-enforcing logic.

Purpose

Guarantees starting pointer alignment for all allocations it manages including allocations due to growth, mutation, extension, and insertion—in all scenarios except for zero-sized types (ZSTs) and capacity 0.

Padding

This allocator does not pad data automatically - it’s purpose is to ensure starting alignment for the memory allocation. When ‘flatbuffering’ multiple buffers, e.g., over the network, or as part of framed payloads, that you later plan to “steal”, for zero-copy memory access, keep in mind that manual padding may be required to ensure all relevant sub-elements also start on a 64-byte boundary.

Trait Implementations

impl Allocator for Alloc64

fn allocate(&self, layout: Layout) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Allocates memory with at least 64-byte alignment.

fn allocate_zeroed(&self, layout: Layout) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Allocates zero-initialised memory with 64-byte alignment.

unsafe fn deallocate(&self, ptr: NonNull<u8>, layout: Layout)

🔬This is a nightly-only experimental API. (allocator_api)

Deallocates memory with alignment correction.

unsafe fn grow( &self, ptr: NonNull<u8>, old: Layout, new: Layout, ) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Grows an existing allocation while preserving 64-byte alignment.

unsafe fn shrink( &self, ptr: NonNull<u8>, old: Layout, new: Layout, ) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Shrinks an allocation while preserving 64-byte alignment.

unsafe fn grow_zeroed( &self, ptr: NonNull<u8>, old: Layout, new: Layout, ) -> Result<NonNull<[u8]>, AllocError>

🔬This is a nightly-only experimental API. (allocator_api)

Grows the allocation to a new layout and zero-initialises any newly allocated region. Existing data is preserved; the new memory is zeroed.

fn by_ref(&self) -> &Self

where Self: Sized,

🔬This is a nightly-only experimental API. (allocator_api)

Returns a reference to the allocator. Useful for adapter traits and APIs requiring allocator references.

impl Clone for Alloc64

fn clone(&self) -> Alloc64

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Alloc64

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

Formats the value using the given formatter.

impl Default for Alloc64

fn default() -> Alloc64

Returns the “default value” for a type.

impl Copy for Alloc64