HelpSource/Classes/BinaryOpFunction.schelp

   1 class:: BinaryOpFunction
   2 summary:: represent a binary operation on a function
   3 categories:: Core
   4 related:: Classes/UnaryOpFunction,Classes/NAryOpFunction,Classes/BinaryOpStream,Classes/Pbinop
   5
   6 description::
   7
   8 Operating on functions instead of numbers, what results is not a result of the calculation, but a structure that represents that calculation.
   9
  10 instanceMethods::
  11
  12 private::storeOn
  13
  14 method::value
  15
  16 Executes each of the operand functions and then performs the selector on the result.
  17
  18 method::valueArray
  19
  20 the same as link::#-value::
  21
  22 examples::
  23
  24 code::
  25 // example
  26 a = 5 + 7; // result is 12.
  27 a = { b } + 7; // result is  a BinaryOpFunction
  28 b = 5;
  29 a.value; // now it is evaluated, and the result is calculated
  30 b = 8;
  31 a.value; // again, with a different value.
  32 ::
  33
  34 code::
  35 // sound example
  36 (
  37 var a = { 19.rand };
  38 var b = { [5, 8, 9].choose };
  39 var c = a + b;
  40 fork {
  41         15.do {
  42                 (instrument: \default, note: [c.value, a.value]).play;
  43                 0.3.wait;
  44         }
  45 }
  46 )
  47 ::