Documentation

doc/staging.md

@@ -59,6 +59,14 @@ In the second example:
 
 The `emit` statements uses generated signal names.
 
+This last example illustrates many of the staging features, included
+those described in the next sections. It shows how to generate a `fork`
+construct with as many branches as values contained in a JavaScript
+array. It shows how to wait for and emit signals whose names are generated.
+
+<span class="hiphop">&#x2605;</span> [staging-fork.hh.js](../test/staging-fork.hh.js)
+<!-- ${doc.includeCode("../test/staging-fork.hh.js", "hiphop")} -->
+
 
 Dynamic Signal Names in Delay Expressions
 -----------------------------------------

test/staging-emit-if2.hh.js

@@ -1,6 +1,3 @@
-"use @hop/hiphop";
-"use hopscript";
-
 import * as hh from "@hop/hiphop";
 import { format } from "util";
 

test/staging-fork.hh.js

@@ -0,0 +1,29 @@
+import * as hh from "@hop/hiphop";
+import { format } from "util";
+
+const Instruments = [ "violin", "piano", "trumpet", "sax" ];
+
+function makeAwait(instruments) {
+   return hiphop fork ${ instruments.map(val => hiphop {
+      await (this[`${val}IN`].nowval);
+      emit ${`${val}OUT`}(${val});
+   }) }
+}
+
+hiphop module prg() {
+   in ... ${ Instruments.map(i => `${i}IN`) };
+   out ... ${ Instruments.map(i => `${i}OUT`) };
+
+   ${ makeAwait(Instruments) }
+}
+
+export const mach = new hh.ReactiveMachine(prg);
+mach.outbuf = "";
+mach.debug_emitted_func = emitted => {
+   mach.outbuf += format(emitted) + "\n";
+}
+
+mach.react();
+mach.react({ violinIN: true, saxIN: true });
+mach.react({ pianoIN: true });
+mach.react()

test/staging-fork.out

@@ -0,0 +1,4 @@
+[]
+[ 'violinOUT("violin")', 'saxOUT("sax")' ]
+[ 'pianoOUT("piano")' ]
+[]