Struct VoidAddr

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

A VoidAddr, much like a void* in C, is available for those in need of a quick-and-dirty way of representing the value of a pointer without actually being able to read from or write to that pointer.

Implementations

impl VoidAddr

pub fn from_addr<A: Address>(ptr: A) -> Self

A void address can be constructed from any other address type.

Trait Implementations

impl Address for VoidAddr

fn from_usize(val: usize) -> VoidAddr

Construct a void address:

let va = VoidAddr::from_usize(0xdeadbeef);

fn as_usize(&self) -> usize

Deconstruct a void address:

let va = VoidAddr::from_usize(0xdeadbeef);
assert!(va.as_usize() == 3735928559);

fn verify(self) -> bool

Trivially verify that this void address looks valid. All values are valid:

let va = VoidAddr::from_usize(0xdeadbeef);
assert!(va.verify());

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

Void addresses cannot be accessed.

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

Void addresses cannot be accessed.

fn memset(&self, _char: u8, _length: usize)

Void addresses 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).

impl Clone for VoidAddr

fn clone(&self) -> VoidAddr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VoidAddr

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

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

impl Display for VoidAddr

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

Display this address as a prettified alphanumeric hex string.

impl Hash for VoidAddr

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 VoidAddr

fn cmp(&self, other: &VoidAddr) -> 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 VoidAddr

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

Address equality delegates to usize equality

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

Address inequality delegates to usize equality

impl PartialOrd for VoidAddr

fn partial_cmp(&self, other: &VoidAddr) -> 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 VoidAddr

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

Display this address as a prettified alphanumeric hex string.

impl UpperHex for VoidAddr

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

Format this address as an alphanumeric hex string.

impl Copy for VoidAddr

impl Eq for VoidAddr