HelpSource/Classes/Penvir.schelp

   1 class:: Penvir
   2 summary:: use an environment when embedding the pattern in a stream
   3 related:: Classes/Pkey
   4 categories:: Streams-Patterns-Events>Patterns>Data Sharing
   5
   6 ClassMethods::
   7
   8 method::new
   9
  10 argument::envir
  11 an environment with objects to embed.
  12
  13 argument::pattern
  14 pattern or stream, ususally a link::Classes/Pfunc::, link::Classes/Prout::.
  15
  16 argument::independent
  17 if true streams can write to the environment without influencing other streams created from this pattern. if false, the streams write to a common namespace.
  18
  19 Examples::
  20
  21 code::
  22 (
  23 x = (a:8);
  24 y = Penvir(
  25         x,
  26         Pfunc { ~a * 2 }
  27 );
  28
  29 t = y.asStream;
  30 )
  31
  32 t.next;
  33
  34
  35
  36 (
  37 x = (a:8);
  38 y = Penvir(
  39         x,
  40         Pfunc { ~a = ~a * 2 }
  41 );
  42
  43 t = y.asStream;
  44 z = y.asStream;
  45 )
  46
  47 t.next;
  48 t.next;
  49 x.postln;       // x stays unchanged
  50 ::