Struct riscy::Addr

pub struct Addr(/* private fields */);

A struct to representing an address value.

Addresses in rv32i are 32-bits wide. We usually write them out in hexadecimal.

Addrs are used in the interface of the Memory trait. An Addr is used to name the location of a specific byte in the memory space.

An important operation for operating for working with Addrs is adding or subtracting an offset. Several RISC-V instructions take a register together with a small immediate value (for example, lw, load word, and jalr, jump-and-link return). The value in the register becomes the base address, but the instruction then operates on memory on a small distance away from the base address. And so, several integer types, (including u32, i32, and RegVal can be added to an Addr.

When using offsets, the order must be: Addr + offset.

It doesn’t make sense to add an Addr to another Addr, so this operation is not provided.

Addrs may be converted to RegVals and vice versa:

let value = RegVal::from_u32(0x2000_0000);
let addr: Addr = value.into();
let new_value = (addr + 0x0a).into();

Addrs can also be compared with <, <=, etc. This is useful for certain implementations of Memory which would like to store Addrs in BTreeMaps.

While Addr (together with the Memory interface) give every byte in memory a unique address, physical hardware often operates with memory on the level of words. That is, it is common that memory might only operate on groups of four bytes. Because of this, some operations will only work when the Addr has a proper alignment.

No restrictions on alignment are given in this version of riscy, but this is subject (and likely) to change in future versions.

Implementations

impl Addr

pub fn new(addr: u32) -> Addr

Trait Implementations

impl Add<RegVal> for Addr

type Output = Addr

The resulting type after applying the + operator.

fn add(self, offset: RegVal) -> Self

Performs the + operation.

impl Add<i32> for Addr

type Output = Addr

The resulting type after applying the + operator.

fn add(self, offset: i32) -> Self

Performs the + operation.

impl Add<u32> for Addr

type Output = Addr

The resulting type after applying the + operator.

fn add(self, offset: u32) -> Self

Performs the + operation.

impl Add<usize> for Addr

type Output = Addr

The resulting type after applying the + operator.

fn add(self, offset: usize) -> Self

Performs the + operation.

impl AddAssign<RegVal> for Addr

fn add_assign(&mut self, offset: RegVal)

Performs the += operation.

impl AddAssign<i32> for Addr

fn add_assign(&mut self, offset: i32)

Performs the += operation.

impl AddAssign<u32> for Addr

fn add_assign(&mut self, offset: u32)

Performs the += operation.

impl AddAssign<usize> for Addr

fn add_assign(&mut self, offset: usize)

Performs the += operation.

impl Clone for Addr

fn clone(&self) -> Addr

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Addr

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

Formats the value using the given formatter.

impl Display for Addr

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

Formats the value using the given formatter.

impl From<Addr> for RegVal

fn from(addr: Addr) -> RegVal

Converts to this type from the input type.

impl From<Addr> for u32

fn from(addr: Addr) -> u32

Converts to this type from the input type.

impl From<Addr> for usize

fn from(addr: Addr) -> usize

Converts to this type from the input type.

impl From<RegVal> for Addr

fn from(val: RegVal) -> Addr

Converts to this type from the input type.

impl Hash for Addr

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Addr

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl PartialEq for Addr

fn eq(&self, other: &Addr) -> bool

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

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Addr

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for Addr

impl Eq for Addr

impl StructuralEq for Addr

impl StructuralPartialEq for Addr