Struct SeriesBuilder

pub struct SeriesBuilder<'a, K, Id: Copy, D: KeyProvidingData<K>, E> { /* private fields */ }

Allows for quick definition of chain of states that follow single path.

Examples

// Creates series of state that will match 'abc' character sequence or go back to root state anytime there is a mismatch.
fn create_abc_series_state_tree() -> Rc<RefCell<dyn AutomatonState<'static, char, TestData, String>>> {
  SeriesBuilder::new_without_default_action(SimpleStateImplementation::new('x'))
  .next_state(char_matcher('a'), SimpleStateImplementation::new('a'))
  .next_state(char_matcher('b'), SimpleStateImplementation::new('b'))
  .next_state(char_matcher('c'), SimpleStateImplementation::new('c'))
  .build()
}

Implementations

impl<'a, K, Id: Copy, D: KeyProvidingData<K>, E> SeriesBuilder<'a, K, Id, D, E>

pub fn new_without_default_action( root: SimpleStateImplementation<'a, K, Id, D, E>, ) -> SeriesBuilder<'a, K, Id, D, E>

pub fn new<FDExec: Fn(&mut D, &K) -> Result<(), E> + 'a>( root: SimpleStateImplementation<'a, K, Id, D, E>, default_execution_function: FDExec, ) -> SeriesBuilder<'a, K, Id, D, E>

pub fn next_state<M>( self, matcher: M, next_state: SimpleStateImplementation<'a, K, Id, D, E>, ) -> SeriesBuilder<'a, K, Id, D, E>

where M: 'a + Fn(&K) -> bool,

Creates new shared simple state and adds new connection to last added state with given matcher.

pub fn next_state_external<M>( self, matcher: M, next_state: &SharedSimpleState<'a, K, Id, D, E>, ) -> SeriesBuilder<'a, K, Id, D, E>

where M: 'a + Fn(&K) -> bool,

WARNING: Passed state will be modified after creating next connection, even before build() is called. Use with caution. Creates connection from last appended state to specified state.

pub fn build(self) -> SharedSimpleState<'a, K, Id, D, E>

Consumes builder and returns root state.