Struct Args 

pub struct Args<'a> { /* private fields */ }

Typed list of arguments for a native function.

Generally the #[native] proc macro builds and consumes an Args automatically — call manually only in raw natives that receive (amx, args) directly.

Implementations

impl<'a> Args<'a>

pub fn new(amx: &'a Amx, params: *const i32) -> Args<'a>

Builds from the Amx and the args pointer received by the native.

Example

use samp_sdk::args::Args;
use samp_sdk::amx::Amx;
use samp_sdk::cell::AmxString;

// native RawNative(const say_that[]);
extern "C" fn raw_native(amx: *mut AMX, args: *mut i32) -> i32 {
    let amx = Amx::new(amx, amx_exports);
    let mut args = Args::new(&amx, args);
    let Some(text) = args.next_arg::<AmxString>() else { return 0 };
    println!("RawNative: {}", &*text);
    1
}

pub fn next_arg<T>(&mut self) -> Option<T>

where T: AmxCell<'a> + 'a,

Next argument in signature order. None at the end of the list.

pub fn get<T>(&self, offset: usize) -> Option<T>

where T: AmxCell<'a> + 'a,

Argument at position offset (zero-indexed). None if out of bounds.

pub fn reset(&mut self)

Resets the next_arg cursor back to the start of the list.

pub fn count(&self) -> usize

How many arguments were received.

Reads from args[0] (total bytes) and divides by 4 (cell size). Negative or zero values return 0 — defense against dirty pointers.