Struct ByteAddr

#[repr(C)]
pub struct ByteAddr(/* private fields */);

A ByteAddr is a value representing the address of zero or more bytes of memory.

Trait Implementations

impl Address for ByteAddr

fn from_usize(val: usize) -> ByteAddr

Constructor for a byte address from a raw usize.

let ba = ByteAddr::from_usize(0xdeadbeef);

fn as_usize(&self) -> usize

Deconstructor for a byte address into a raw usize value.

let ba = ByteAddr::from_usize(0xdeadbeef);
assert!(ba.as_usize() == 3735928559);

fn verify(self) -> bool

All byte addresses are valid:

let ba = ByteAddr::from_usize(0xdeadbeef);
assert!(ba.verify());

fn load<T: Copy>(&self) -> T

A generic address to a raw byte cannot be accessed.

fn store<T>(&self, value: T)

A generic address to a raw byte cannot be accessed.

fn plus<A: Address>(&self, bytes: usize) -> A

Add some number of bytes to this address, producing an address of type A.

fn sub<A: Address>(&self, bytes: usize) -> A

Subtract some number of bytes from this address, producing an address of type A.

fn offset<T, A: Address>(&self, offset: usize) -> A

Offset this &self address some number of instances of type T, producing an address of type A.

fn is_zero(&self) -> bool

Is the value of this address equivalent to the (universal) null value?

fn align_up<A: Address>(&self, align: usize) -> A

Align this pointer up (increasing value) to the nearest address with a value aligned to align bytes. For example the following properties hold:

fn gte<A: Address>(&self, addr: A) -> bool

Is the value of this address greater than or equal to the value of the given address?

fn greater<A: Address>(&self, addr: A) -> bool

Is the value of this address greater than the value of the given address?

fn lte<A: Address>(&self, addr: A) -> bool

Is the value of this address less than or equal to the value of the given address?

fn less<A: Address>(&self, addr: A) -> bool

Is the value of this address less than the value of the given address?

fn is_aligned_to(&self, align: usize) -> bool

Is the value of this address exactly aligned to the given alignment?

fn from_ptr<T>(ptr: *const T) -> Self

Construct an address from an immutable constant Rust pointer type.

fn to_ptr<T>(&self) -> *const T

Deconstruct an address into an immutable constant Rust pointer type.

fn to_ptr_mut<T>(&self) -> *mut T

Construct an address from a mutable constant Rust pointer type.

fn zero() -> Self

Construct the (universal) null address.

fn diff<A: Address>(&self, another: A) -> usize

Compute the number of bytes before this address (exclusive) and after another address (inclusive).

fn memset(&self, val: u8, length: usize)

Set the first length bytes pointed to by this address to the byte val.

impl Clone for ByteAddr

fn clone(&self) -> ByteAddr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ByteAddr

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

Display this address as a prettified alphanumeric hex string for debugging.

impl Display for ByteAddr

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

Display this address as a prettified alphanumeric hex string.

impl Hash for ByteAddr

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 ByteAddr

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

Address ordinality delegates to usize ordinality.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ByteAddr

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

Address equality delegates to usize equality

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

Address inequality delegates to usize equality

impl PartialOrd for ByteAddr

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

Address ordinality delegates to usize ordinality.

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl Pointer for ByteAddr

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

Display this address as a prettified alphanumeric hex string.

impl UpperHex for ByteAddr

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

Format this address as an alphanumeric hex string.

impl Copy for ByteAddr

impl Eq for ByteAddr