Struct Allocator 

pub struct Allocator<'amx> { /* private fields */ }

AMX heap allocator with automatic release (RAII).

Captures the value of amx.hea at creation time and restores it on Drop, freeing everything allocated by the Allocator in a single operation. Do not use multiple nested Allocators — each one restores to a different heap point.

Implementations

impl<'amx> Allocator<'amx>

pub fn allot<T>(&self, init_value: T) -> Result<Ref<'_, T>, AmxError>

where T: AmxPrimitive,

Allocates a single cell on the heap and initializes it with init_value.

Errors

AmxError::Memory if the VM heap is exhausted.

pub fn allot_buffer(&self, size: usize) -> Result<Buffer<'_>, AmxError>

Allocates size cells on the heap and returns a Buffer covering that region.

Errors

AmxError::Memory if the VM heap is exhausted or if size exceeds i32::MAX.

pub fn allot_array<T>(&self, array: &[T]) -> Result<Buffer<'_>, AmxError>

where T: AmxCell<'amx> + AmxPrimitive,

Allocates space for array.len() cells and copies the content (AmxCell::as_cell).

Errors

AmxError::Memory if the VM heap is exhausted.

pub fn allot_string(&self, string: &str) -> Result<AmxString<'_>, AmxError>

Allocates space for a string and copies string (configured encoding), adding the 0 terminator at the end.

Errors

AmxError::Memory if the VM heap is exhausted.

Trait Implementations

impl Drop for Allocator<'_>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.