Struct syntect::parsing::SyntaxSetBuilder

pub struct SyntaxSetBuilder { /* private fields */ }

A syntax set builder is used for loading syntax definitions from the file system or by adding SyntaxDefinition objects.

Once all the syntaxes have been added, call build to turn the builder into a SyntaxSet that can be used for parsing or highlighting.

Implementations

impl SyntaxSetBuilder

pub fn new() -> SyntaxSetBuilder

pub fn add(&mut self, syntax: SyntaxDefinition)

Add a syntax to the set.

pub fn syntaxes(&self) -> &[SyntaxDefinition]

The list of syntaxes added so far.

pub fn build(self) -> SyntaxSet

Build a SyntaxSet from the syntaxes that have been added to this builder.

Linking

The contexts in syntaxes can reference other contexts in the same syntax or even other syntaxes. For example, a HTML syntax can reference a CSS syntax so that CSS blocks in HTML work as expected.

Those references work in various ways and involve one or two lookups. To avoid having to do these lookups during parsing/highlighting, the references are changed to directly reference contexts via index. That’s called linking.

Linking is done in this build step. So in order to get the best performance, you should try to avoid calling this too much. Ideally, create a SyntaxSet once and then use it many times. If you can, serialize a SyntaxSet for your program and when you run the program, directly load the SyntaxSet.

Trait Implementations

impl Clone for SyntaxSetBuilder

fn clone(&self) -> SyntaxSetBuilder

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for SyntaxSetBuilder

fn default() -> SyntaxSetBuilder

Returns the “default value” for a type.