Struct TextVersion 

pub struct TextVersion {
    pub strs: u64,
    pub tags: u64,
    pub meta_tags: u64,
}

A representation of how many changes took place in a Text.

The purpose of this struct is merely to be compared with previously acquired instances of itself, to just quickly check if certain properties of the Text have changed.

Note that this is a Text agnostic struct, comparing the TextVersions from two different Texts is pointless.

Fields

strs: u64

The current version of the Strs.

Any change to the Strs, even undoing, will incur a version increment.

tags: u64

the current version of Tags.

Any change to the Tags, be it addition or removal of Tags, will incur a version increment.

meta_tags: u64

The current version of meta Tags.

Meta tags are those that can change what is even shown on the screen, all else being equal. Any addition or removal of meta Tags will incur a version increment.

Implementations

impl TextVersion

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

Wether there have been any changes to the Text since this previous instance.

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

Wether the Strs have changed since this previous instance.

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

Wether the Tags have changed since this previous instance.

Note that this only tracks if Tags have been added/removed. So if, for example, you replace a range where no Tags existed, this would return false, even though the position of Tags have changed internally.

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

Wether this Text has “structurally changed” since this previous instance.

A Text has structurally changed when printing it from the same point could result in a different characters being printed. This not only happens when the Strs change, but also with certain Tags, like Ghost and Conceal, which also add and remove characters to be printed.

These Tags are called “meta tags” internally, since they change the very structure of what Text has been printed.

Trait Implementations

impl Clone for TextVersion

fn clone(&self) -> TextVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TextVersion

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

Formats the value using the given formatter.

impl PartialEq for TextVersion

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

impl Eq for TextVersion

impl StructuralPartialEq for TextVersion