Enum talloc::Span

pub enum Span {
    Empty,
    Sized {
        base: isize,
        acme: isize,
    },
}

Variants

Empty

Sized

Fields

base: isize

acme: isize

Implementations

impl Span

pub const fn new(base: isize, acme: isize) -> Self

pub const fn from_base_size(base: isize, size: usize) -> Self

If the base is greater than acme, returns a span with the given base and a size of zero.

pub fn from_ptr_size(ptr: *mut u8, size: usize) -> Self

pub fn from_ptr_slice(slice: *mut [u8]) -> Self

pub fn from_ptr_range(range: Range<*mut u8>) -> Self

pub const fn to_ptr_range(self) -> Option<Range<*mut u8>>

pub const fn to_slice(self) -> Option<*mut [u8]>

pub const fn is_empty(self) -> bool

pub const fn size(self) -> usize

pub const fn contains(self, addr: isize) -> bool

Returns whether self contains other.

Signed comparisons are used.

pub fn contains_ptr(self, ptr: *mut u8) -> bool

Returns whether self contains other.

Signed comparisons are used.

pub const fn contains_span(self, span: Span) -> bool

Returns whether self contains other.

Empty spans are contained by any span, even empty ones.

pub const fn overlaps(self, span: Span) -> bool

Returns whether some of self overlaps some of other.

Empty spans don’t overlap with anything.

pub const fn word_align_inward(self) -> Self

Aligns base upward and acme() downward by align_of::<usize>().

pub const fn word_align_outward(self) -> Self

Aligns base downward and acme upward by align_of::<usize>().

pub const fn above(self, min: isize) -> Self

Raises base if base is smaller than min.

pub const fn below(self, max: isize) -> Self

Lowers acme if acme is greater than max.

pub const fn fit_within(self, span: Span) -> Self

Returns a span that other contains by raising base or lowering acme.

If other is empty, returns other.

pub const fn fit_over(self, span: Self) -> Self

Returns a span that contains other by extending self.

If other is empty, returns self, as all spans contain any empty span.

pub const fn extend(self, low: usize, high: usize) -> Self

Lower base by low and raise acme by high.

pub const fn truncate(self, low: usize, high: usize) -> Span

Raise base by low and lower size by low + high (zero, if this underflows).

Trait Implementations

impl Clone for Span

fn clone(&self) -> Span

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Span

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

Formats the value using the given formatter.

impl Default for Span

fn default() -> Self

Returns the “default value” for a type.

impl Display for Span

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

Formats the value using the given formatter.

impl From<&mut [u8]> for Span

fn from(value: &mut [u8]) -> Self

Converts to this type from the input type.

impl From<*mut [u8]> for Span

fn from(value: *mut [u8]) -> Self

Converts to this type from the input type.

impl From<Range<*mut u8>> for Span

fn from(value: Range<*mut u8>) -> Self

Converts to this type from the input type.

impl From<Range<isize>> for Span

fn from(value: Range<isize>) -> Self

Converts to this type from the input type.

impl PartialEq<Span> for Span

fn eq(&self, other: &Span) -> 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 Copy for Span

impl Eq for Span

impl StructuralEq for Span

impl StructuralPartialEq for Span