HelpSource/Classes/Interpreter.schelp

   1 class::Interpreter
   2 summary:: The interpreter defines a context in which interactive commands are compiled and executed.
   3 categories:: Core>Kernel
   4
   5 description::
   6 In the interpreter, code::this:: refers to the interpreter itself, e.g.: code::this.postln::
   7
   8 classMethods::
   9
  10 private::new
  11
  12 instanceMethods::
  13
  14 subsection::Accessing
  15
  16 The interpreter defines instance variables code::a:: through code::z:: which are always available in the interpreter. By convention, the variable code::s:: is used to hold the default Server. Assigning another value to code::s:: may cause some of the examples in the documentation to fail.
  17
  18 method::clearAll
  19
  20 set the values of the variables code::a:: through code::z:: to nil.
  21
  22 code::
  23 x = 123;
  24 x.postln;
  25 this.clearAll;
  26 x.postln;
  27 ::
  28
  29 subsection::Compile & Interpret
  30
  31 method::interpret
  32
  33 Compile and execute a link::Classes/String::.
  34
  35 code::
  36 this.interpret("(123 + 4000).postln");
  37 ::
  38
  39 method::interpretPrint
  40
  41 Compile and execute a link::Classes/String::, printing the result.
  42
  43 code::
  44 this.interpretPrint("123 + 4000");
  45 ::
  46
  47 method::compile
  48
  49 Compile a String and return a link::Classes/Function::.
  50
  51 code::
  52 (
  53 z = this.compile("(123 + 4000).postln");
  54 z.postln;
  55 z.value;
  56 )
  57 ::
  58
  59 method::compileFile
  60
  61 Reads the file at pathName, compiles it and returns a Function.
  62 The file must contain a valid SuperCollider expression, naturally.
  63 This will not compile class definitions, only expressions.
  64
  65 method::executeFile
  66
  67 Reads the file at pathName, compiles it and executes it, returning the result.
  68 The file must contain a valid SuperCollider expression, naturally.
  69 This will not compile class definitions, only expressions.
  70
  71 method::cmdLine
  72
  73 Returns the previosly interpreted code.
  74
  75 code::
  76 1 + 2;
  77 this.cmdLine
  78 ::
  79
  80 method::codeDump
  81
  82 this interpreter variable can be set to evaluate a function with any sucessfully compiled code.
  83 see e.g. the class History.
  84
  85 code::
  86 a = [ ]; // store all the code evaulated in a
  87 this.codeDump = { |code| a = a.add(code) };
  88 1 + 3;
  89 f = { "hallo" };
  90 a.postcs;
  91 codeDump = nil; // reset to nil.
  92 ::
  93
  94 method::preProcessor
  95
  96 can be used to modify code before it is interpreted. Given appropriate delimiters, this can be used to implement little languages.
  97
  98 code::
  99 // silly but simple: understand a Saw for every SinOsc
 100 this.preProcessor = { |code| code.replace("SinOsc", "Saw") };
 101
 102 { SinOsc.ar(200) * 0.1 }.play;
 103
 104 preProcessor = nil; // reset to nil.
 105 ::
 106
 107