Struct stackdump_core::memory_region::ArrayMemoryRegion
source · [−]pub struct ArrayMemoryRegion<const SIZE: usize> { /* private fields */ }
Expand description
A memory region that is backed by a stack allocated array
Implementations
sourceimpl<const SIZE: usize> ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> ArrayMemoryRegion<SIZE>
sourcepub fn new(start_address: u64, data: ArrayVec<u8, SIZE>) -> Self
pub fn new(start_address: u64, data: ArrayVec<u8, SIZE>) -> Self
Creates a new memory region starting at the given address with the given data
sourcepub fn bytes(&self) -> MemoryRegionIterator<'_>ⓘNotable traits for MemoryRegionIterator<'a>impl<'a> Iterator for MemoryRegionIterator<'a> type Item = u8;
pub fn bytes(&self) -> MemoryRegionIterator<'_>ⓘNotable traits for MemoryRegionIterator<'a>impl<'a> Iterator for MemoryRegionIterator<'a> type Item = u8;
Get a byte iterator for this region.
This iterator can be used to store the region as bytes or to stream over a network. The iterated bytes include the length so that if you use the FromIterator implementation, it consumes only the bytes that are part of the collection. This means you can chain multiple of these iterators after each other.
use arrayvec::ArrayVec;
use stackdump_core::memory_region::{ArrayMemoryRegion, MemoryRegion};
let region1 = ArrayMemoryRegion::<4>::new(0, ArrayVec::from([1, 2, 3, 4]));
let region2 = ArrayMemoryRegion::<4>::new(100, ArrayVec::from([5, 6, 7, 8]));
let mut intermediate_buffer = Vec::new();
intermediate_buffer.extend(region1.bytes());
intermediate_buffer.extend(region2.bytes());
let mut intermediate_iter = intermediate_buffer.iter();
assert_eq!(region1, ArrayMemoryRegion::<4>::from_iter(&mut intermediate_iter));
assert_eq!(region2, ArrayMemoryRegion::<4>::from_iter(&mut intermediate_iter));
sourcepub unsafe fn copy_from_memory(&mut self, data_ptr: *const u8, data_len: usize)
pub unsafe fn copy_from_memory(&mut self, data_ptr: *const u8, data_len: usize)
Clears the existing memory data and copies the new data from the given pointer
If the data_len is greater than the capacity of this memory region, then this function will panic.
Safety
The entire block of memory from data_ptr .. data_ptr + data_len
must be readable.
(A memcpy must be possible with the pointer as source)
Trait Implementations
sourceimpl<const SIZE: usize> Clone for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> Clone for ArrayMemoryRegion<SIZE>
sourcefn clone(&self) -> ArrayMemoryRegion<SIZE>
fn clone(&self) -> ArrayMemoryRegion<SIZE>
Returns a copy of the value. Read more
1.0.0 · sourcefn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
sourceimpl<const SIZE: usize> Debug for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> Debug for ArrayMemoryRegion<SIZE>
sourceimpl<const SIZE: usize> Default for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> Default for ArrayMemoryRegion<SIZE>
sourcefn default() -> ArrayMemoryRegion<SIZE>
fn default() -> ArrayMemoryRegion<SIZE>
Returns the “default value” for a type. Read more
sourceimpl<'de, const SIZE: usize> Deserialize<'de> for ArrayMemoryRegion<SIZE>
impl<'de, const SIZE: usize> Deserialize<'de> for ArrayMemoryRegion<SIZE>
sourcefn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
sourceimpl<'a, const SIZE: usize> FromIterator<&'a u8> for ArrayMemoryRegion<SIZE>
impl<'a, const SIZE: usize> FromIterator<&'a u8> for ArrayMemoryRegion<SIZE>
sourcefn from_iter<T: IntoIterator<Item = &'a u8>>(iter: T) -> Self
fn from_iter<T: IntoIterator<Item = &'a u8>>(iter: T) -> Self
Creates a value from an iterator. Read more
sourceimpl<const SIZE: usize> FromIterator<u8> for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> FromIterator<u8> for ArrayMemoryRegion<SIZE>
sourcefn from_iter<T: IntoIterator<Item = u8>>(iter: T) -> Self
fn from_iter<T: IntoIterator<Item = u8>>(iter: T) -> Self
Creates a value from an iterator. Read more
sourceimpl<const SIZE: usize> MemoryRegion for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> MemoryRegion for ArrayMemoryRegion<SIZE>
sourcefn read(&self, index: Range<u64>) -> Result<Option<Vec<u8>>, MemoryReadError>
fn read(&self, index: Range<u64>) -> Result<Option<Vec<u8>>, MemoryReadError>
Returns the slice of memory that can be found at the given address_range. If the given address range is not fully within the captured region, then None is returned. Read more
sourcefn read_u8(&self, address: u64) -> Result<Option<u8>, MemoryReadError>
fn read_u8(&self, address: u64) -> Result<Option<u8>, MemoryReadError>
Reads a byte from the given address if it is present in the region
sourcefn read_u32(
&self,
address: u64,
endianness: RunTimeEndian
) -> Result<Option<u32>, MemoryReadError>
fn read_u32(
&self,
address: u64,
endianness: RunTimeEndian
) -> Result<Option<u32>, MemoryReadError>
Reads a u32 from the given address if it is present in the region
sourceimpl<const SIZE: usize> PartialEq<ArrayMemoryRegion<SIZE>> for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> PartialEq<ArrayMemoryRegion<SIZE>> for ArrayMemoryRegion<SIZE>
sourcefn eq(&self, other: &ArrayMemoryRegion<SIZE>) -> bool
fn eq(&self, other: &ArrayMemoryRegion<SIZE>) -> bool
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
sourcefn ne(&self, other: &ArrayMemoryRegion<SIZE>) -> bool
fn ne(&self, other: &ArrayMemoryRegion<SIZE>) -> bool
This method tests for !=
.
sourceimpl<const SIZE: usize> Serialize for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> Serialize for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> StructuralPartialEq for ArrayMemoryRegion<SIZE>
Auto Trait Implementations
impl<const SIZE: usize> RefUnwindSafe for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> Send for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> Sync for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> Unpin for ArrayMemoryRegion<SIZE>
impl<const SIZE: usize> UnwindSafe for ArrayMemoryRegion<SIZE>
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more