HelpSource/Reference/if.schelp

   1 title:: if
   2 categories::Core, Common methods
   3 related:: Guides/Control-Structures
   4 summary:: conditional execution
   5
   6 method:: if
   7
   8 section::example
   9 code::
  10 if ( [false, true].choose,                              // Boolean expression (chooses one at random)
  11         { "expression was true".postln },       // true function
  12         { "expression was false".postln }       // false function
  13 )
  14
  15 (
  16 var a = 1, z;
  17 z = if (a < 5, { 100 },{ 200 });
  18 z.postln;
  19 )
  20 ::
  21
  22 UGens can also use if
  23
  24 the condition ugen is 0 / 1
  25
  26 code::
  27 (
  28         {
  29                 if( LFNoise1.kr(1.0,0.5,0.5) , SinOsc.ar, Saw.ar )
  30         }.play
  31 )
  32 ::
  33
  34 section:: optimization
  35
  36 the functions will be inlined, which plucks the code from the functions and uses a more efficient jump statement.
  37
  38 code::
  39 {
  40         if( 6 == 9,{
  41                 "hello".postln;
  42         },{
  43                 "hello".postln;
  44         })
  45 }.def.dumpByteCodes
  46
  47 BYTECODES: (18)
  48   0   FE 06    PushPosInt 6
  49   2   FE 09    PushPosInt 9
  50   4   E6       SendSpecialBinaryArithMsg '=='
  51   5   F8 00 06 JumpIfFalse 6  (14)
  52   8   42       PushLiteral "hello"
  53   9   A1 00    SendMsg 'postln'
  54  11   FC 00 03 JumpFwd 3  (17)
  55  14   41       PushLiteral "hello"
  56  15   A1 00    SendMsg 'postln'
  57  17   F2       BlockReturn
  58 a FunctionDef in closed FunctionDef
  59 ::
  60
  61
  62
  63
  64 failure to inline due to variable declarations
  65 code::
  66 {
  67
  68         if( 6 == 9,{
  69                 var notHere;
  70                 "hello".postln;
  71         },{
  72                 "hello".postln;
  73         })
  74
  75 }.def.dumpByteCodes
  76
  77 WARNING: FunctionDef contains variable declarations and so will not be inlined.
  78    in file 'selected text'
  79    line 4 char 14 :
  80                 var notHere;•
  81                 "hello".postln;
  82 -----------------------------------
  83 BYTECODES: (12)
  84   0   FE 06    PushPosInt 6
  85   2   FE 09    PushPosInt 9
  86   4   E6       SendSpecialBinaryArithMsg '=='
  87   5   04 00    PushLiteralX instance of FunctionDef in closed FunctionDef
  88   7   04 01    PushLiteralX instance of FunctionDef in closed FunctionDef
  89   9   C3 0B    SendSpecialMsg 'if'
  90  11   F2       BlockReturn
  91 a FunctionDef in closed FunctionDef
  92 ::
  93
  94 code::
  95 {
  96         if( 6 == 9,{
  97                 "hello".postln;
  98         },{
  99                 "hello".postln;
 100         })
 101 }.def.dumpByteCodes
 102
 103 BYTECODES: (18)
 104   0   FE 06    PushPosInt 6
 105   2   FE 09    PushPosInt 9
 106   4   E6       SendSpecialBinaryArithMsg '=='
 107   5   F8 00 06 JumpIfFalse 6  (14)
 108   8   42       PushLiteral "hello"
 109   9   A1 00    SendMsg 'postln'
 110  11   FC 00 03 JumpFwd 3  (17)
 111  14   41       PushLiteral "hello"
 112  15   A1 00    SendMsg 'postln'
 113  17   F2       BlockReturn
 114 a FunctionDef in closed FunctionDef
 115 ::