Struct customizable_buddy::BuddyAllocator

pub struct BuddyAllocator<const N: usize, O: OligarchyCollection, B: BuddyCollection> { /* private fields */ }

伙伴分配器。

Implementations

impl<const N: usize, O: OligarchyCollection, B: BuddyCollection> BuddyAllocator<N, O, B>

pub const fn new() -> Self

构造分配器。

pub fn capacity(&self) -> usize

返回分配器管理的总容量。

pub fn free(&self) -> usize

返回分配器剩余的空间容量。

pub fn init<T>(&mut self, min_order: usize, base: NonNull<T>)

运行时初始化。

设置分配器分配的最小阶数和基址。

pub unsafe fn transfer<T>(&mut self, ptr: NonNull<T>, size: usize)

将一个 ptr 指向的长度为 usize 的内存块转移给分配器。

Safety

调用者需要保证：

• 这个内存块没有被其他任何对象引用；
• 这个内存块和已经托管的内存块不重叠。

pub fn snatch<T>(
    &mut self,
    align_order: usize,
    size: NonZeroUsize
) -> Result<(NonNull<T>, usize), BuddyError>

从分配器夺走一个对齐到 align_order 阶，长度为 size 的内存块。

pub fn allocate_type<T>(&mut self) -> Result<(NonNull<T>, usize), BuddyError>

分配可容纳 T 对象的内存块。

pub fn allocate_layout<T>(
    &mut self,
    layout: Layout
) -> Result<(NonNull<T>, usize), BuddyError>

分配符合 layout 布局的内存块。

pub fn allocate<T>(
    &mut self,
    align_order: usize,
    size: NonZeroUsize
) -> Result<(NonNull<T>, usize), BuddyError>

分配。

如果分配成功，返回一个 (指针, 长度) 二元组。

pub unsafe fn deallocate_layout<T>(&mut self, ptr: NonNull<T>, layout: Layout)

根据布局回收。

Safety

这个方法认为 ptr 是根据 layout 分配出来的， 因此长度不小于 layout.size() 并且对齐到 self.min_order。

pub fn deallocate<T>(&mut self, ptr: NonNull<T>, size: usize)

回收。

Notice

调用者需要保证 size 对齐了分配器的最小阶数。

Trait Implementations

impl<const N: usize, O: OligarchyCollection + Debug, B: BuddyCollection + Debug> Debug for BuddyAllocator<N, O, B>

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

Formats the value using the given formatter.