NAME

Gfsm::Automaton::Indexed - libgfsm finite-state automata, indexed

SYNOPSIS

            

              
              
use Gfsm;
##------------------------------------------------------------
## Constructors, etc.
$xfsm = Gfsm::Automaton::Indexed->new();
$xfsm = Gfsm::Automaton::Indexed->new($is_transducer,$srtype,$n_states,$n_arcs);
$xfsm2 = $xfsm->clone();     # copy constructor
$xfsm2->assign($xfsm1);      # assigns $fsm1 to $fsm2
$xfsm->clear();              # clear automaton structure
##--------------------------------------------------------------
## Import & Export
$fsm  = $xfsm->to_automaton();   # convert Gfsm::Automaton::Indexed -> Gfsm::Automaton
$xfsm = $fsm->to_indexed();      # convert Gfsm::Automaton -> Gfsm::Automaton::Indexed
##------------------------------------------------------------
## Accessors/Manipulators: Properties
$bool = $xfsm->is_transducer();           # get 'is_transducer' flag
$bool = $xfsm->is_transducer($bool);      # ... or set it
$bool = $xfsm->is_weighted(?$bool);       # get/set 'is_weighted' flag
$mode = $xfsm->sort_mode(?$mode);         # get/set sort-mode flag (dangerous)
$bool = $xfsm->is_deterministic(?$bool);  # get/set 'is_deterministic' flag (dangerous)
$srtype = $xfsm->semiring_type(?$srtype); # get/set semiring type
$n = $xfsm->n_states();                   # get number of states
$n = $xfsm->n_arcs();                     # get number of arcs
$id   = $xfsm->root(?$id);                # get/set id of initial state
$bool = $xfsm->has_state($id);            # check whether a state exists
##------------------------------------------------------------
## Accessors/Manipulators: States
$id = $xfsm->add_state();                 # add a new state
$id = $xfsm->ensure_state($id);           # ensure that a state exists
$xfsm->remove_state($id);                 # remove a state from an FSM (currently does nothing)
$bool = $xfsm->is_final($id,?$bool);      # get/set final-flag for state $id
$deg  = $xfsm->out_degree($id);           # get number of outgoing arcs for state $id
$w    = $xfsm->final_weight($id,?$w);     # get/set final weight for state $id
##------------------------------------------------------------
## Accessors/Manipulators: Arcs
$fsm->arcsort($fsm,$mode);               # sort automaton arcs
##-- TODO: arc range iterator access!
##--------------------------------------------------------------
## I/O
$bool = $xfsm->load($filename_or_handle);   # load binary file
$bool = $xfsm->save($filename_or_handle);   # save binary file
$bool = $xfsm->load_string($buffer);        # load from in-memory buffer $string
$bool = $xfsm->save_string($buffer);        # save to in-memory buffer $string
$bool = $xfsm->viewps(%options);            # for debugging (uses to_automaton())
            
          

DESCRIPTION

Not yet written.

BUGS AND LIMITATIONS

Probably many.

SEE ALSO

Gfsm(3perl), Gfsm::Automaton(3perl), gfsmutils(1).

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2005-2008 by Bryan Jurish

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.14.2 or, at your option, any later version of Perl 5 you may have available.