Struct Builder 

pub struct Builder<T, State = (), Heap = ()> { /* private fields */ }

A builder for Parser.

Examples

Basics

use whitehole::{parser::Parser, combinator::eat};

Parser::builder()
  // Set the entry action
  .entry(eat("hello ") + "world")
  // Build the parser
  .build("hello world");

Contextual

use whitehole::{parser::Parser, combinator::contextual};

// Generate contextual combinators
contextual!(MyState, MyHeap);

Parser::builder()
  // Set the state
  .state(MyState::new())
  // Set the heap
  .heap(MyHeap::new())
  // Set the entry action
  .entry(eat("hello ") + "world")
  // Build the parser
  .build("hello world");

Implementations

impl Builder<(), (), ()>

pub const fn new() -> Self

Create a new instance with Parser::state and Parser::heap set to ().

impl<T, State, Heap> Builder<T, State, Heap>

pub fn state<NewState>(self, state: NewState) -> Builder<T, NewState, Heap>

Set Parser::state.

pub fn heap<NewHeap>(self, heap: NewHeap) -> Builder<T, State, NewHeap>

Set Parser::heap.

pub fn entry<Entry>(self, entry: Entry) -> Builder<Entry, State, Heap>

Set Parser::entry.

pub fn build<Text: ?Sized>(self, text: &Text) -> Parser<'_, T>

where T: Action<Text = Text, State = State, Heap = Heap>,

Build a Parser with the given text.

Trait Implementations

impl<T: Clone, State: Clone, Heap: Clone> Clone for Builder<T, State, Heap>

fn clone(&self) -> Builder<T, State, Heap>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Copy, State: Copy, Heap: Copy> Copy for Builder<T, State, Heap>

impl<T: Debug, State: Debug, Heap: Debug> Debug for Builder<T, State, Heap>

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

Formats the value using the given formatter.

impl Default for Builder<(), (), ()>

fn default() -> Self

Returns the “default value” for a type.