Struct stackdump_core::register_data::VecRegisterData

pub struct VecRegisterData<RB> { /* private fields */ }

A collection of registers, backed by a vec.

Implementations

impl<RB: Integral> VecRegisterData<RB>

pub fn new(starting_register: Register, registers: Vec<RB>) -> Self

Create a new register collection backed by a vec

• The registers must be sequential according to the dwarf register numbers.
• All registers that are in the collection must have their true value.

pub fn bytes(&self) -> RegisterDataBytesIterator<'_, RB>

Get a byte iterator for this collection.

This iterator can be used to store the collection 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::register_data::{ArrayRegisterData, RegisterData};

let regs1 = ArrayRegisterData::<4, u32>::new(stackdump_core::gimli::Arm::R0, ArrayVec::from([1, 2, 3, 4]));
let regs2 = ArrayRegisterData::<4, u32>::new(stackdump_core::gimli::Arm::R0, ArrayVec::from([5, 6, 7, 8]));

let mut intermediate_buffer = Vec::new();

intermediate_buffer.extend(regs1.bytes());
intermediate_buffer.extend(regs2.bytes());

let mut intermediate_iter = intermediate_buffer.iter().copied();

assert_eq!(regs1, ArrayRegisterData::<4, u32>::from_iter(&mut intermediate_iter));
assert_eq!(regs2, ArrayRegisterData::<4, u32>::from_iter(&mut intermediate_iter));

Trait Implementations

impl<RB: Clone> Clone for VecRegisterData<RB>

fn clone(&self) -> VecRegisterData<RB>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<RB: Debug> Debug for VecRegisterData<RB>

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

Formats the value using the given formatter.

impl<RB: Default> Default for VecRegisterData<RB>

fn default() -> VecRegisterData<RB>

Returns the “default value” for a type.

impl<'de, RB> Deserialize<'de> for VecRegisterData<RB> where
    RB: Deserialize<'de>, 

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl<RB> FromIterator<u8> for VecRegisterData<RB> where
    RB: Integral,
    RB::Bytes: for<'a> TryFrom<&'a [u8]>, 

fn from_iter<T: IntoIterator<Item = u8>>(iter: T) -> Self

Creates a value from an iterator.

impl<RB: PartialEq> PartialEq<VecRegisterData<RB>> for VecRegisterData<RB>

fn eq(&self, other: &VecRegisterData<RB>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &VecRegisterData<RB>) -> bool

This method tests for !=.

impl<RB: Integral> RegisterData<RB> for VecRegisterData<RB>

fn register(&self, register: Register) -> Option<RB>

Try to get the value of the given register. Returns None if the register is not present in this collection.

fn register_ref(&self, register: Register) -> Option<&RB>

Try to get a reference to the given register. Returns None if the register is not present in this collection.

fn register_mut(&mut self, register: Register) -> Option<&mut RB>

Try to get a mutable reference to the given register. Returns None if the register is not present in this collection.

impl<RB> Serialize for VecRegisterData<RB> where
    RB: Serialize, 

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl<RB> StructuralPartialEq for VecRegisterData<RB>