Struct HighlightState

pub struct HighlightState {
    pub path: ScopeStack,
    /* private fields */
}

Keeps a stack of scopes and styles as state between highlighting different lines.

If you are highlighting an entire file you create one of these at the start and use it all the way to the end.

Caching

One reason this is exposed is that since it implements Clone you can actually cache these (probably along with a ParseState) and only re-start highlighting from the point of a change. You could also do something fancy like only highlight a bit past the end of a user’s screen and resume highlighting when they scroll down on large files.

Alternatively you can save space by caching only the path field of this struct then re-create the HighlightState when needed by passing that stack as the initial_stack parameter to the new method. This takes less space but a small amount of time to re-create the style stack.

Note: Caching is for advanced users who have tons of time to maximize performance or want to do so eventually. It is not recommended that you try caching the first time you implement highlighting.

Fields

path: ScopeStack

Implementations

impl HighlightState

pub fn new( highlighter: &Highlighter<'_>, initial_stack: ScopeStack, ) -> HighlightState

Note that the Highlighter is not stored; it is used to construct the initial stack of styles.

Most of the time you’ll want to pass an empty stack as initial_stack, but see the docs for HighlightState for a discussion of advanced caching use cases.

Trait Implementations

impl Clone for HighlightState

fn clone(&self) -> HighlightState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HighlightState

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

Formats the value using the given formatter.

impl PartialEq for HighlightState

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

impl StructuralPartialEq for HighlightState