HelpSource/Classes/Pcollect.schelp

   1 class:: Pcollect
   2 summary:: Apply a function to a pattern
   3 categories:: Streams-Patterns-Events>Patterns>Filter
   4 related:: Classes/Pselect, Classes/Preject
   5
   6 description::
   7 Modifies each value by passing it to the function.
   8
   9
  10 classmethods::
  11
  12 method:: new
  13 argument:: func
  14 A link::Classes/Function::. Receives values from code::pattern::.
  15 argument:: pattern
  16 A link::Classes/Pattern::.
  17
  18
  19 examples::
  20 code::
  21 (
  22 var a, b;
  23 a = Pcollect({ arg item; item * 3 }, Pseq(#[1, 2, 3],inf));
  24 x = a.asStream;
  25 9.do({ x.next.postln; });
  26 )
  27 ::
  28
  29 The message code::collect:: returns a Pcollect when passed to a pattern. Note that because the pattern is converted to a link::Classes/Stream:: (more precisely a link::Classes/FuncStream::) the collect function is evaluated for one item each time the message code::next:: is passed.
  30 code::
  31 (
  32 var a, b;
  33 a = Pseq(#[1, 2, 3],inf).collect({ arg item; item * 3 });
  34 a.postln;
  35 x = a.asStream;
  36 9.do({ x.next.postln; });
  37 )
  38 ::