The Runtime

The Runtime is another property which exists on your script's base class MyGridProgram, alongside Storage, Me and Echo. This property contains information about the running environment of your script. Specifically these members:

• TimeSinceLastRun
  Gets the time elapsed since the last time the Main method of this program was run. This property returns no valid data neither in the constructor nor the Save method. Also keep in mind that the very first time a script is run each session, this property will be empty (TimeSpan.Zero) since - obviously - there hasn't been a last run yet.

• LastRunTimeMs
  Gets the time in fractional milliseconds it took to execute the Main method the last time it was run. This method returns no valid data neither in the constructor nor the Save method. You can use this property to profile your script and find out whether it runs fast enough.

• MaxInstructionCount
  In order to help keeping the runtime of scripts down to a reasonable level, the programmable block imposes a maximum number of significant instructions before a script is deemed too complex and forcefully terminated. A "significant instruction" includes conditionals (if/else), switches, method calls and similar. Exactly what a "significant instruction" is is not important, this is just a tool to help you stop the most obvious mistakes. This property gets the maximum number of significant instructions that can be executed during a single run, including any other programmable blocks invoked immediately. Note that if you're even remotely close to this maximum limit, your script is probably doing way too much. Advanced users can see here for a very useful trick to keep the instruction count down and performance hit low while still running complicated operations.

• CurrentInstructionCount
  Gets the current number of significant instructions executed so far this run.