View source for Machine.initiate

== Calling Pattern ==
Call
 local m = sl.machine(a[,b])
 -- later
 local r = m.initiate([d[,...]])
Args
 d1..dN optional are variadic arguments of any type
Results
 r0..rN are values returned by the a.exit function

== Example Usage ==

 local s = {
  initiate = function(h,...) local a = {...} print('initiating '..a[1]) return 'a' end,
  a        = function(h) print('a')       return 'b'    end,
  b        = function(h) print('b')       return 'c'    end,
  c        = function(h) print('c')       return 'exit' end,
  exit     = function(h) print('exiting') return 999    end,
  monitor  = function(s,h,n,g) if g=='exit' then h[1]=h[1]+1; if h[1]<3 then g='a' end end; return g end,
  }

 local h = {0}
 local m = sl.machine(s,h)
 local n = m.initiate('live')
 print(tostring(n))

 --> initiating live
     a
     b
     c
     a
     b
     c
     a
     b
     c
     exiting
     999

== Description ==

Calling initiate begins the execution of a previously defined state machine object by calling the function associated with the 'initiate' key in the state table.  If no errors are encountered during execution, initiate returns the results returned by the 'exit' state function.

== Upon Error ==

Requesting a non-existent state key during any transition is an error.  Errors occurring in any of the state functions are reported and handled according to the operant error redirection mode

== See Also ==

* [http://www.easyuo.com/openeuo/wiki/index.php/Simplelib simplelib]

* [[case]]
* [[chain]]
* [[iterator]]
* [[machine]]
* [[spin]]