Struct Span 

pub struct Span { /* private fields */ }

A window on an axis, in whatever Unit its Track counts.

The axis a Track draws. Offsets rather than instants, because a description carrying a DateTime would carry a timezone with it and the vocabulary has no business holding one. The app knows which day or month this is; the description says how far along it a thing sits.

to is exclusive and may exceed the natural period, which is how a span running past the end is said without a second date: under Unit::Minutes, Span::new(1320, 1560) is 22:00 to 02:00.

Implementations

impl Span

pub const DAY: Self

Midnight to midnight, the ordinary day.

pub const fn new(from: u16, to: u16) -> Self

A span, clamped to a sane one.

An empty or backwards span is a caller bug that should not cost a renderer a division by zero, so to is forced at least one minute past from rather than returning an error nobody can act on. Same reasoning as Share::percent, which clamps rather than refuses.

pub const fn from(self) -> u16

The first minute on the axis.

pub const fn to(self) -> u16

One past the last minute on the axis.

pub const fn length(self) -> u16

How much the axis covers, in its track’s unit. Never zero.

pub const fn holds(self, minute: u16) -> bool

Whether an offset falls on this axis.

Trait Implementations

impl Clone for Span

fn clone(&self) -> Span

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Span

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 Eq for Span

impl Hash for Span

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 PartialEq for Span

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Span