Getting Results : Finally
Finally represents the OMLoop output. It
is evaluated when the iterative process is over and returns its final
result(s) .
If nothing is connected to it, the evaluation of OMLoop returns “nil”.
Example : Enumeration of a List
The following example uses an iterator : listloop. at each step of a loop, listloop enumerates an element of a list, then the following element, and so on, until the list is exhausted.
-
Here, there are four iterations during which listloop takes the successive values from the list.
-
At the end of this process, Finally returns the current value listloop, that is, the last value of the list.
-
This value is the result of OMLoop.
—|—
Finally Inputs : OMLoop Outputs
Finally has one default input : “patch”. It can be added as many optional inputs as necessary : “oppatch”.
The optional inputs of finally can be used as additional outputs for OMLoop to return data to external elements in a higher-level program.
—|—
Multiple Outputs and “Once” Mode
When an OMLoop has several outputs, it is advised to set it on “evaluate- once” mode to avoid useless multiple evaluations. When the OMLoop is evaluated, the result displayed by the Listener is that of the first output.
—|—
References :
Contents :
- OpenMusic Documentation
- OM User Manual
- OpenMusic QuickStart