Struct Range 

pub struct Range { /* private fields */ }

An ordered span between two places, begin <= end.

Construction normalizes, so a Range can never run backwards. That is the point: every consumer of a span wants it ordered, and the one thing that wants direction — a selection — keeps its two places itself.

use pdfrum_form::edit::{Place, Range};

let lo = Place::new(0, 0, Some(1));
let hi = Place::new(0, 0, Some(5));
// Whichever order the two arrive in, the span is the same.
assert_eq!(Range::new(lo, hi), Range::new(hi, lo));
assert_eq!(Range::new(hi, lo).begin(), lo);
assert_eq!(Range::new(hi, lo).end(), hi);

Implementations

impl Range

pub fn new(a: Place, b: Place) -> Range

The span between two places, in whichever order they arrive.

use pdfrum_form::edit::{Place, Range};

let backwards = Range::new(Place::new(0, 0, Some(7)), Place::new(0, 0, Some(2)));
assert!(backwards.begin() <= backwards.end());
assert_eq!(backwards.begin(), Place::new(0, 0, Some(2)));

pub fn empty_at(place: Place) -> Range

An empty span at one place.

use pdfrum_form::edit::{Place, PlaceExt, Range};

assert!(Range::empty_at(Place::start()).is_empty());

pub fn begin(self) -> Place

The earlier end.

use pdfrum_form::edit::{Place, Range};

let span = Range::new(Place::new(0, 0, Some(5)), Place::new(0, 0, Some(1)));
assert_eq!(span.begin(), Place::new(0, 0, Some(1)));

pub fn end(self) -> Place

The later end.

use pdfrum_form::edit::{Place, Range};

let span = Range::new(Place::new(0, 0, Some(5)), Place::new(0, 0, Some(1)));
assert_eq!(span.end(), Place::new(0, 0, Some(5)));

pub fn is_empty(self) -> bool

Whether the span covers nothing.

use pdfrum_form::edit::{Place, PlaceExt, Range};

assert!(Range::empty_at(Place::start()).is_empty());
assert!(!Range::new(Place::start(), Place::new(0, 0, Some(0))).is_empty());

Trait Implementations

impl Clone for Range

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Range

impl Debug for Range

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

Formats the value using the given formatter.

impl Eq for Range

impl PartialEq for Range

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Range