B4P Reference

Function Names

stop

Description

Program execution will stop and enters interactive mode. This exception is actually applied for most program errors. In the interactive mode, you can inspect the global and local variables and table contents. Typing "return" will move you one level up if 'stop' was called in a user-defined function or B4P program called with start() or include(). Otherwise the (last) return command will exit B4P.

This function call is recommended for program debugging.

Call as: procedure

Restrictions

Indirect parameter passing is disabled

Parameter count

Examples

  define procedure( foo )

  {

      a[] = 123;

      stop;

      echo("Continuing");

  }



  echo("Started.");

  foo;

  echo("Finished.");

Output

Started.

stop (); called

Code execution will stop.  Going to interactive mode

________________________________________________________________________



Type 'help' for help, 'docs' for B4P docs, 'web docs' for online docs.

>> echo( a[] )

123

>> return



Type 'help' for help, 'docs' for B4P docs, 'web docs' for online docs.

>> echo( a[] )



Row #: Code Text _______________________________________________________

  1: echo( a[] )

           ^

Inside the program code entered interactively:

Attempting to read variable 'a[...]'.

Failed to access variable: Variable name not found.

Code execution will stop.  Going to interactive mode

________________________________________________________________________



Type 'help' for help, 'docs' for B4P docs, 'web docs' for online docs.

>> return

Done - Press ENTER key

stop