NAME

Gfsm::XL::Cascade - object-oriented interface to libgfsmxl finite-state cascades

SYNOPSIS

 use Gfsm;
 use Gfsm::XL;

 ##------------------------------------------------------------
 ## Constructors, etc.

 $csc = Gfsm::XL::Cascade->new();
 $csc = Gfsm::XL::Cascade->new($depth, $srtype);

 $csc->clear();             # clear cascade

 ##------------------------------------------------------------
 ## Accessors/Manipulators: Properties

 $csc   = $csc->append(@fsms);            # append a Gfsm::Automaton::Indexed (by reference if possible)
 $xfsm  = $csc->get($n);                  # retrieve reference to $n-th automaton in the cascade (indexed)
 @xfsms = $csc->get_all();                # retrieve list of references to all automata in cascade
 $xold  = $csc->set($n,$fsm);             # set the $n-th automaton in the cascade; returns old $n-th automaton
 $xold  = $csc->pop();                    # pop the deepest automaton in the cascade

 $depth  = $csc->depth();                 # get cascade depth
 $srtype = $csc->semiring_type(?$srtype); # get/set semiring type

 $csc->sort_all($sort_mask);              # sort all automata in cascade

 ##--------------------------------------------------------------
 ## I/O

 $bool = $csc->load($filename_or_handle);   # load binary file
 $bool = $csc->save($filename_or_handle);   # save binary file

 $bool = $csc->load_string($buffer);        # load from in-memory buffer $string
 $bool = $csc->save_string($buffer);        # save to in-memory buffer $string

DESCRIPTION

Not yet written.

BUGS AND LIMITATIONS

Probably many.

SEE ALSO

Gfsm(3perl), gfsmutils(1).

AUTHOR

Bryan Jurish <moocow@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2005-2012 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.10.1 or, at your option, any later version of Perl 5 you may have available.