Struct ArgumentStorage 

pub struct ArgumentStorage { /* private fields */ }

Storage for method arguments.

Arguments are passed to a method by the caller and can be read or modified during method execution. For instance methods, argument 0 is typically this.

Example

use dotscope::emulation::{ArgumentStorage, EmValue};
use dotscope::metadata::typesystem::CilFlavor;

// Create arguments from caller's values
let mut args = ArgumentStorage::new(
    vec![EmValue::I32(10), EmValue::I32(20)],
    vec![CilFlavor::I4, CilFlavor::I4],
);

// Access arguments
assert_eq!(args.get(0).unwrap(), &EmValue::I32(10));
assert_eq!(args.get(1).unwrap(), &EmValue::I32(20));

// Modify argument (for ref/out parameters)
args.set(0, EmValue::I32(42)).unwrap();

Implementations

impl ArgumentStorage

pub fn new(values: Vec<EmValue>, types: Vec<CilFlavor>) -> Self

Creates argument storage from caller values and types.

Arguments

• values - Values passed by the caller
• types - CIL type flavors for each argument

Panics

Panics if values and types have different lengths.

pub fn with_this( this_ref: EmValue, arg_values: Vec<EmValue>, arg_types: Vec<CilFlavor>, ) -> Self

Creates argument storage for an instance method.

Argument 0 will be the this reference.

Arguments

• this_ref - The ‘this’ object reference
• arg_values - Additional argument values
• arg_types - CIL type flavors for additional arguments

pub fn empty() -> Self

Creates empty argument storage.

pub fn get(&self, index: usize) -> Result<&EmValue>

Gets the value of an argument.

Arguments

• index - The argument index (0-based)

Errors

Returns EmulationError::ArgumentIndexOutOfBounds if index is out of bounds.

pub fn get_mut(&mut self, index: usize) -> Result<&mut EmValue>

Gets a mutable reference to an argument.

Arguments

• index - The argument index (0-based)

Errors

Returns EmulationError::ArgumentIndexOutOfBounds if index is out of bounds.

pub fn set(&mut self, index: usize, value: EmValue) -> Result<()>

Sets the value of an argument.

This is used for ref/out parameters that can be modified.

Arguments

• index - The argument index (0-based)
• value - The new value

Errors

Returns error if index is out of bounds or type mismatches.

pub fn get_type(&self, index: usize) -> Result<&CilFlavor>

Gets the type of an argument.

Arguments

• index - The argument index (0-based)

Errors

Returns error if index is out of bounds.

pub fn this(&self) -> Option<&EmValue>

Gets the this reference for instance methods.

Returns

Some(&EmValue) if this is an instance method, None otherwise.

pub fn has_this(&self) -> bool

Returns true if this is an instance method.

pub fn count(&self) -> usize

Returns the number of arguments.

pub fn is_empty(&self) -> bool

Returns true if there are no arguments.

pub fn values(&self) -> &[EmValue]

Returns a slice of all argument values.

pub fn types(&self) -> &[CilFlavor]

Returns a slice of all argument types.

pub fn iter(&self) -> impl Iterator<Item = (usize, &EmValue)>

Returns an iterator over (index, value) pairs.

pub fn snapshot(&self) -> Vec<EmValue>

Creates a snapshot of the current argument state.

pub fn restore(&mut self, snapshot: Vec<EmValue>)

Restores arguments from a previous snapshot.

Panics

Panics if snapshot length doesn’t match argument count.

Trait Implementations

impl Clone for ArgumentStorage

fn clone(&self) -> ArgumentStorage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ArgumentStorage

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

Formats the value using the given formatter.

impl Default for ArgumentStorage

fn default() -> Self

Returns the “default value” for a type.

impl Display for ArgumentStorage

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

Formats the value using the given formatter.