Click above to get retro games delivered to your door ever month!

  CALL

  .  Summary

  call(str <scriptname>, <arg1>, <arg2>, <arg3>, ...);

  .  Description

  The call function is used when one script file must call (jump into
  and then return from) another. <scriptname> is the name of the
  script file to call. If no extension is given, .SLC is assumed.
  <arg1> through <argn> are the arguments or parameters to be passed
  to the 'main' function of the called script. The value returned is
  the value returned by the 'main' function of the called script, and
  can be an integer or a string value, although the called script can
  not return string variables local to itself. If the script file to
  be called is already in memory because it was previously loaded and
  made resident, or it is still executing from a previous call, it is
  not released but instead the memory image is used. This means that
  global variables will have whatever values a previous run through
  left in them.

  The calld function is exactly the same as the call function, except
  that even if an image of the indicated script file is already in
  memory, a new copy is still loaded from disk. This ensures that
  global variables within the script will be set as defined in the
  source file, and that there will be enough stack space, but requires
  more memory and is slower.

  .  Return Value

  An integer or string value representing the value returned by the
  main function of the called script file. This value must not be a
  string variable defined within the called script, for memory rea-
  sons. if the indicated script can not be found or loaded, a value of
  -1 is returned. If the called script is aborted by the user, a value
  of -1 is returned.

  .  Example

  stat = call("TEST");
  if (stat == -1)
   prints("Called script could not be loaded or was aborted!");