Struct tokay::Context

pub struct Context<'runtime, 'program, 'reader, 'parselet> { /* private fields */ }

Contexts represent stack frames for parselet calls.

Via the context, most operations regarding capture storing and loading is performed.

Implementations

impl<'runtime, 'program, 'reader, 'parselet> Context<'runtime, 'program, 'reader, 'parselet>

pub fn new(
    runtime: &'runtime mut Runtime<'program, 'reader>,
    parselet: &'parselet Parselet,
    locals: usize,
    take: usize,
    hold: usize,
    depth: usize
) -> Self

pub fn debug(&self, msg: &str)

Print debug output with context depth indention

pub fn push(&self, value: RefValue) -> Result<Accept, Reject>

Shortcut for an Ok(Accept::Push) with the given value. To push a value immediatelly, use context.runtime.stack.push().

pub fn pop(&mut self) -> RefValue

Pop value off the stack.

pub fn peek(&mut self) -> RefValue

Peek top value of stack.

pub fn load(&mut self, index: usize) -> Result<Accept, Reject>

pub fn get_capture(&mut self, pos: usize) -> Option<RefValue>

Return a capture by index as RefValue.

pub fn get_capture_by_name(&mut self, name: &str) -> Option<RefValue>

Return a capture by name as RefValue.

pub fn set_capture(&mut self, pos: usize, value: RefValue)

Set a capture to a RefValue by index.

pub fn set_capture_by_name(&mut self, name: &str, value: RefValue)

Set a capture to a RefValue by name.

Trait Implementations

impl<'runtime, 'program, 'reader, 'parselet> Drop for Context<'runtime, 'program, 'reader, 'parselet>

fn drop(&mut self)

Executes the destructor for this type.