SegregatedBumpAllocator

Struct SegregatedBumpAllocator 

Source
pub struct SegregatedBumpAllocator;
Expand description

Minimal Allocator with Fixed Bins + Bump Pointer Fallback.

极简固定分箱 + Bump Pointer 回退分配器。

§Design Philosophy

  • Extreme Size: Abandon Coalescing and Splitting, remove all complex list traversals and metadata headers.
  • Speed First: Small object allocation/deallocation are strictly O(1).
  • Use Cases: Wasm Serverless functions, short-lived scripts, or scenarios with ample memory but sensitive to startup speed/size.

§设计哲学

  • 极简体积:放弃合并(Coalescing)与拆分(Splitting),移除所有复杂的链表遍历和元数据头。
  • 速度优先:小对象分配/释放均为严格的 O(1)。
  • 场景定位:Wasm Serverless 函数、短生命周期脚本、或内存充裕但对启动速度/体积敏感的场景。

§Memory Layout

  • Bin 0: 16 Bytes (for Box, small structs)
  • Bin 1: 32 Bytes
  • Bin 2: 64 Bytes
  • Bin 3: 128 Bytes
  • Large: > 128 Bytes, allocated directly using Bump Pointer, not reused.

§内存布局

  • Bin 0: 16 Bytes (用于 Box, small structs)
  • Bin 1: 32 Bytes
  • Bin 2: 64 Bytes
  • Bin 3: 128 Bytes
  • Large: > 128 Bytes,直接使用 Bump Pointer 分配,不复用。

Implementations§

Source§

impl SegregatedBumpAllocator

Source

pub const fn new() -> Self

Source

pub unsafe fn reset()

⚠️ Test/Bench only: Reset global state

⚠️ 仅用于测试/Bench:重置全局状态

Trait Implementations§

Source§

impl GlobalAlloc for SegregatedBumpAllocator

Source§

unsafe fn alloc(&self, layout: Layout) -> *mut u8

Allocates memory as described by the given layout. Read more
Source§

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

Deallocates the block of memory at the given ptr pointer with the given layout. Read more
1.28.0§

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

Behaves like alloc, but also ensures that the contents are set to zero before being returned. Read more
1.28.0§

unsafe fn realloc( &self, ptr: *mut u8, layout: Layout, new_size: usize, ) -> *mut u8

Shrinks or grows a block of memory to the given new_size in bytes. The block is described by the given ptr pointer and layout. Read more
Source§

impl Sync for SegregatedBumpAllocator

Safety Warning: Allocators in this module are designed for [Single Threaded] environments. Sync is implemented only to satisfy GlobalAlloc trait requirements. Using this allocator in a multi-threaded environment will lead to Undefined Behavior (UB). Please ensure it is used only in single-threaded environments (e.g., WASM or single-threaded embedded).

安全性警示 (Safety Warning): 本模块中的分配器均为【单线程】设计。 实现了 Sync 仅为了满足 GlobalAlloc trait 的要求。 在多线程环境中使用此分配器会导致未定义行为 (UB)。 请确保只在单线程环境(如 WASM 或单线程嵌入式环境)中使用。

Auto Trait Implementations§

Blanket Implementations§

§

impl<T> Any for T
where T: 'static + ?Sized,

§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
§

impl<T> Borrow<T> for T
where T: ?Sized,

§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
§

impl<T> BorrowMut<T> for T
where T: ?Sized,

§

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

Mutably borrows from an owned value. Read more
§

impl<T> From<T> for T

§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T, U> Into<U> for T
where U: From<T>,

§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.