Struct Ranges 

pub struct Ranges { /* private fields */ }

A list of non intersecting exclusive Range<usize>s

The primary purpose of this struct is to serve Parsers by telling Duat which ranges need to be updated. This lets Duat minimize as much as possible the amount of work done to update the Text when it changes in a Buffer.

Implementations

impl Ranges

pub fn new(range: Range<usize>) -> Self

Return a new instance of Ranges with an initial Range

pub fn empty() -> Self

Returns a new empty Ranges

pub fn set_min_len(&mut self, min: usize)

Sets a minimum length to keep Ranges

pub fn add(&mut self, new: Range<usize>)

Adds a range to the list of Range<usize>s

This range will be merged in with the others on the list, so it may bridge gaps between ranges or for longer ranges within, without allowing for the existance of intersecting ranges.

pub fn remove( &mut self, within: Range<usize>, ) -> impl ExactSizeIterator<Item = Range<usize>> + '_

Removes a Range from the list, returning an Iterator over the Ranges that were taken

pub fn merge(&mut self, other: Self)

Applies the add function to another Rangess

pub fn shift_by(&mut self, from: usize, shift: i32)

Shifts the Ranges within by a Change

If the diff is negative (i.e. a part of the ranges were removed), then ranges will be removed ahead of from accordingly.

pub fn len(&self) -> usize

Returns the number of Range<usize>s

pub fn is_empty(&self) -> bool

Returns true if there are no Range<usize>s

pub fn iter(&self) -> impl Iterator<Item = Range<usize>>

An Iterator over the Ranges in this list

pub fn iter_over( &self, within: Range<usize>, ) -> impl Iterator<Item = Range<usize>>

The same as Ranges::remove, but without removing, just iterating over the relevant ranges

Trait Implementations

impl Clone for Ranges

fn clone(&self) -> Ranges

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Ranges

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

Formats the value using the given formatter.

impl Default for Ranges

fn default() -> Ranges

Returns the “default value” for a type.

impl IntoIterator for Ranges

type IntoIter = IntoIter

Which kind of iterator are we turning this into?

type Item = Range<usize>

The type of the elements being iterated over.

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.