Editing Return

'''Syntax:'''
  return

== Summary of command ==
Return is used to force a '''script''' to stop processing from that line on. It does not JUST terminate the current block, it terminates the script for the rest of the that iteration of the script in that frame, including the blocks below, if any.

If the script uses a block that runs for multiple frames, such as [[GameMode]], the script will be run again in the next frame. Return can be useful inside of [[If]] statements by allowing you to prevent the lines following the return from being processed. 



== Minimizing CPU strain using the Return command ==
Return can be used in If-EndIf blocks to minimize the amount of CPU bandwidth required to process that script in one frame. See the relevant chapter of the [[Minimizing_your_Script#An_important_note_on_If_blocks_vs_early_Returns|Minimizing your Script]] page for more information concerning this issue.

[[Category: Commands]]



-------------------------------------------------------
( never used a Wiki before, hope I do this right )
-------------------------------------------------------

I had a glitch in a script, and careful debugging has taught me that RETURN is a little more powerful than first suspected.

The scripts are designed with the BEGIN <event> syntax.
I was considering these independednt functions called seperately.
However if within the same frame execution you have more than one <event> expected to be processed, and use RETURN in the first <event> for any reason. No other <event>s will be processed.

The clear example I discovered, was using RETURN within an OnLoad event. Which ultimately glitched the necessary OnReset event. Because OnLoad and OnReset are processed at the same frame during a cell load the OnLoad event exited the script before the OnReset had a chance to process.

''Begin OnLoad
  If doOnce == 1
    Return
  Endif
  ; Stuff to do once
End

Begin OnReset
  ; Stuff to do every Reset
End''

The "stuff to do every reset" will only process the one time OnLoad processes.

RETURN as clearly stated in the Wiki exits the script, not the OnLoad function.

Just thought I would add this bit of business so others would not make the same mistake I did. I hope it helps.
-Dejunai