Struct csx64::exec::Memory

pub struct Memory { /* fields omitted */ }

The memory module of an emulator.

Implementations

impl Memory

pub fn len(&self) -> usize

Gets the length of the currently allocated block of memory.

pub fn get(&self, pos: u64, len: u64) -> Result<&[u8], ExecError>

Grabs a contiguous block of memory. Fails if the block goes out of bounds.

pub fn get_mut(&mut self, pos: u64, len: u64) -> Result<&mut [u8], ExecError>

Similar to get but returns a mutable slice. Additionally, fails if grabbing from readonly memory.

pub fn set(&mut self, pos: u64, value: &[u8]) -> Result<(), ExecError>

Assigns a binary value to memory. Equivalent to assigning to the result of get_mut. On failure, the internal state is unmodified.

pub fn get_null_terminated(&self, pos: u64) -> Result<&[u8], ExecError>

Reads a null-terminated binary string starting at the given position. The null terminator is not included in the result. If pos itself is a null terminator, returns an empty slice. Fails if no null terminator is found or the range goes out of bounds.

pub fn set_null_terminated(
    &mut self,
    pos: u64,
    value: &[u8]
) -> Result<(), ExecError>

Writes a null-terminated binary string to the given position. Note that the value need not be null terminated: we simply append a terminator in the internal representation. Indeed, zeros in the value are included verbatim, though they will not be present with the matching read function. Fails if the result goes out of bounds or intersects readonly memory. On failure, the internal state is unmodified.

pub fn get_u8(&self, pos: u64) -> Result<u8, ExecError>

pub fn set_u8(&mut self, pos: u64, val: u8) -> Result<(), ExecError>

pub fn get_u16(&self, pos: u64) -> Result<u16, ExecError>

pub fn set_u16(&mut self, pos: u64, val: u16) -> Result<(), ExecError>

pub fn get_u32(&self, pos: u64) -> Result<u32, ExecError>

pub fn set_u32(&mut self, pos: u64, val: u32) -> Result<(), ExecError>

pub fn get_u64(&self, pos: u64) -> Result<u64, ExecError>

pub fn set_u64(&mut self, pos: u64, val: u64) -> Result<(), ExecError>

pub fn get_i8(&self, pos: u64) -> Result<i8, ExecError>

pub fn set_i8(&mut self, pos: u64, val: i8) -> Result<(), ExecError>

pub fn get_i16(&self, pos: u64) -> Result<i16, ExecError>

pub fn set_i16(&mut self, pos: u64, val: i16) -> Result<(), ExecError>

pub fn get_i32(&self, pos: u64) -> Result<i32, ExecError>

pub fn set_i32(&mut self, pos: u64, val: i32) -> Result<(), ExecError>

pub fn get_i64(&self, pos: u64) -> Result<i64, ExecError>

pub fn set_i64(&mut self, pos: u64, val: i64) -> Result<(), ExecError>

pub fn get_f32(&self, pos: u64) -> Result<f32, ExecError>

pub fn set_f32(&mut self, pos: u64, val: f32) -> Result<(), ExecError>

pub fn get_f64(&self, pos: u64) -> Result<f64, ExecError>

pub fn set_f64(&mut self, pos: u64, val: f64) -> Result<(), ExecError>

pub fn get_f80(&self, pos: u64) -> Result<F80, ExecError>

pub fn set_f80(&mut self, pos: u64, val: F80) -> Result<(), ExecError>

Trait Implementations

impl Default for Memory

fn default() -> Memory

Returns the “default value” for a type.