Struct scdlang::Scdlang

pub struct Scdlang<'g> {
    pub semantic_error: bool,
    // some fields omitted
}

Core parser and also Builder.

Examples

use scdlang::semantics::Kind;

let mut parser = Scdlang::new();
parser.with_err_path("test.scl")

for semantic_type in iter_from(source)? {
	match semantic_type {
		Kind::Expression(expr) => {/* expr.[methods] */}
		Kind::Statement(stmnt) => {/* stmnt.[methods] */}
		Kind::Declaration(declr) => {
			/*
			declr.expressions.[methods] // access each expressions
			declr.statements.[methods] //access each statements
			*/
		}
	}
}

Fields

semantic_error: bool

Methods

impl<'s> Scdlang<'s>

pub fn new() -> Self

This method is prefered for instantiating than using Default::default()

pub fn finish(self) -> Result<Self, Error>

Call this when Drop cause panic!.

Manually drop this object which can return Err(Deadlock), useful when in multi-thread process.

impl<'g> Scdlang<'g>

pub fn parse(&self, source: &'g str) -> Result<Pairs<Rule>, Error>

Parse from source and also reformat the error messages.

pub fn parse_from(source: &str) -> Result<Pairs<Rule>, Error>

Parse from source but don't modify or fix the error messages.

pub fn iter_from(&self, source: &'g str) -> Result<Vec<Kind>, Error>

Parse from source then iterate. This is the preferred methods for implementing transpiler, codegen, or compiler.

Trait Implementations

impl<'g> Builder<'g> for Scdlang<'g>

fn with_err_path(&mut self, path: &'g str) -> &mut dyn Builder<'g>

Set path that going to be printed in the error essages.

fn with_err_line(&mut self, line: usize) -> &mut dyn Builder<'g>

Set the line_of_code offset of the error essages.

fn with_err_semantic(&mut self, default: bool) -> &mut dyn Builder<'g>

Enable semantics error. (default: true).

fn auto_clear_cache(&mut self, default: bool) -> &mut dyn Builder<'g>

Automatically clear cache when out of scope. * default - set false to disable it. (default: true)

impl<'g> Drop for Scdlang<'g>

fn drop(&mut self)

Executes the destructor for this type.

impl<'g> Default for Scdlang<'g>

fn default() -> Scdlang<'g>

Returns the "default value" for a type.

impl<'g> Clone for Scdlang<'g>

fn clone(&self) -> Scdlang<'g>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'_> Display for Scdlang<'_>

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

Formats the value using the given formatter.

impl<'g> Parser<Rule> for Scdlang<'g>

fn parse<'i>(rule: Rule, input: &'i str) -> Result<Pairs<'i, Rule>, Error<Rule>>

Parses a &str starting from rule.