company logo

Set break point (BREAK)

The command sets a break point at passed or current position.

Parameters:

  • fname - function name for the function for setting the break point. The function is searched in the current context, i.e. the currently selected data type and its base types.
  • class - In order to list functions in a different class, the function name has to be scoped.
  • line_number - In order to set a break point on another than the current line a line number may be passed, which is valid in the selected frame. Valid line numbers are displayed when calling the list (L) command
  • proc_name - A procedure name containing a list of commands to be executed when reaching the breakpoint. The procedure name is either an entry point defined in the calling OShell script file or a file path to an OShell script file with a preceeding entry point name (e.g. ~/procs/breakpoints.osh@break12)
  • do|begin - In order to enter break point procedure statements at run time DO or BEGIN may be passed instead of procedure name. After entering one or more commands, END may be entered in order to terminate the procedure. In contrast to file procedured, RETURN is not required.

Syntax:

  break|b [[class::]fname] [line_number] [proc_name|do|begin]

Examples:

  b                 // set breakpont at current line

  b 10              // set breakpont at line number 10

  b bp10            // set breakpont at current line and call procedure  

                    // bp10 always when reaching the breakpoint.