Struct UnsizedBuffer 

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

Array with unknown size — received as a native argument when the Pawn signature is array[] without a fixed dimension.

The actual size usually comes as another parameter (sizeof(array)). Use into_sized_buffer to convert into Buffer before iterating.

Implementations

impl<'amx> UnsizedBuffer<'amx>

pub fn into_sized_buffer(self, len: usize) -> Buffer<'amx>

Converts into Buffer by declaring the size.

len should be the real Pawn array size (sizeof(arr)). A len larger than the actual array still reads/writes neighbouring cells of the same script (wrong data, not a crash), so never pass a size the script can control independently. The SDK clamps len two ways as a safety net: to the VM data region [0, stp) (so an oversized len cannot read or write past the AMX allocation and segfault) and to a 1 MiB ceiling.

pub fn as_ptr(&self) -> *const i32

Pointer to the first cell.

pub fn as_mut_ptr(&mut self) -> *mut i32

Mutable pointer to the first cell.

pub fn write_str(self, max_len: usize, s: &str) -> Result<(), AmxError>

Sizes the buffer to max_len and writes s in one call.

Equivalent to into_sized_buffer(max_len).write_str(s). This is the recommended way to fill an output string in natives.

Errors

AmxError::General if the encoded s is >= max_len (no room for the 0 terminator).

Trait Implementations

impl<'amx> AmxCell<'amx> for UnsizedBuffer<'amx>

fn from_raw(amx: &'amx Amx, cell: i32) -> Result<UnsizedBuffer<'amx>, AmxError>

Reconstructs the value from a raw AMX cell.

fn as_cell(&self) -> i32