Struct Change 

pub struct Change<'h, S = &'h str> { /* private fields */ }

A change in a buffer, with a start, taken text, and added text.

Implementations

impl Change<'static, String>

pub fn new( edit: impl ToString, range: Range<Point>, text: &Text, ) -> Change<'static, String>

Returns a new Change.

pub fn as_ref(&self) -> Change<'_>

Returns a copyable Change.

pub fn try_merge(&mut self, older: Change<'static, String>)

In this function, it is assumed that self happened after newer.

If the merger fails, the older Change will be returned;

impl<'h> Change<'h>

pub fn to_string_change(&self) -> Change<'static, String>

Creates a Change<String> from a Change<&str>.

pub fn str_insert(added_str: &'h str, start: Point) -> Change<'h>

Returns a new copyable Change from an insertion.

impl<'s, S> Change<'s, S>

where S: Borrow<str>,

pub fn reverse(self) -> Change<'s, S>

Returns a reversed version of this Change.

pub fn line_range(&self, strs: &Strs) -> Range<Point>

Gets a Range<Point>, from the start to the end of the affected lines.

For example, if you make an edit that transforms lines 1..=3 to lines 1..=5, this function will return a Range that starts at the beginning of line 1, and ends at the end of line 5.

Note

This end of this range will come after the last \n, which means that, in that example, said point would have a Point::line value equal to 6, not 5, since it represents both the end of line 5, and the beginning of line 6.

pub fn start(&self) -> Point

The Point at the start of the change.

pub fn taken_end(&self) -> Point

Returns the end of the Change, before it was applied.

pub fn added_end(&self) -> Point

Returns the end of the Change, after it was applied.

pub fn taken_range(&self) -> Range<Point>

Returns the taken Range.

pub fn added_range(&self) -> Range<Point>

Returns the added Range.

pub fn added_str(&self) -> &str

The text that was taken on this Change.

pub fn taken_str(&self) -> &str

The text that was added by this Change.

pub fn taken_byte_col(&self, strs: &Strs) -> usize

The ending byte column before this Change took place.

You shouldn’t call change.end_point().byte_col(strs) because that will calculate the byte column with the new state of the Text, when you should be doing so with the old state.

This function does that for you.

pub fn taken_char_col(&self, strs: &Strs) -> usize

The ending char column before thiss Change took place.

You shouldn’t call change.end_point().char_col(strs) because that will calculate the byte column with the new state of the Text, when you should be doing so with the old state.

This function does that for you.

pub fn shift(&self) -> [i32; 3]

The total shift caused by this Change.

Trait Implementations

impl<'de, Context> BorrowDecode<'de, Context> for Change<'static, String>

fn borrow_decode<D>( decoder: &mut D, ) -> Result<Change<'static, String>, DecodeError>

where D: BorrowDecoder<'de, Context = Context>,

Attempt to decode this type with the given BorrowDecode.

impl<'h, S> Clone for Change<'h, S>

where S: Clone,

fn clone(&self) -> Change<'h, S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'s, S> Debug for Change<'s, S>

where S: Debug,

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

Formats the value using the given formatter.

impl<Context> Decode<Context> for Change<'static, String>

fn decode<D>(decoder: &mut D) -> Result<Change<'static, String>, DecodeError>

where D: Decoder<Context = Context>,

Attempt to decode this type with the given Decode.

impl<'h, S> Default for Change<'h, S>

where S: Default,

fn default() -> Change<'h, S>

Returns the “default value” for a type.

impl Encode for Change<'static, String>

fn encode<E>(&self, encoder: &mut E) -> Result<(), EncodeError>

where E: Encoder,

Encode a given type.

impl<'h, S> Ord for Change<'h, S>

where S: Ord,

fn cmp(&self, other: &Change<'h, S>) -> Ordering

This method returns an Ordering between self and other.

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<'h, S> PartialEq for Change<'h, S>

where S: PartialEq,

fn eq(&self, other: &Change<'h, S>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'h, S> PartialOrd for Change<'h, S>

where S: PartialOrd,

fn partial_cmp(&self, other: &Change<'h, S>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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<'h, S> Copy for Change<'h, S>

where S: Copy,

impl<'h, S> Eq for Change<'h, S>

where S: Eq,

impl<'h, S> StructuralPartialEq for Change<'h, S>