Class: Breakpoint

• Inheritance
• Description
• Class protocol
  • instance creation
  • queries
  • utilities
• Instance protocol
  • accessing
  • hitting
  • initialization
  • printing & storing
  • support
  • testing

Inheritance:

   Object
   |
   +--Breakpoint

Package:

stx:libcomp

Category:

System-Compiler-Debugging

Version:

rev: 1.60 date: 2024/02/09 11:12:10

user: stefan

file: Breakpoint.st directory: libcomp

module: stx stc-classLibrary: libcomp

Description:

statement breakpoint support.
Instances of me are placed into a (bytecode-) compiled method's
literal array and are sent #break messages when a statement
with a breakpoint is about to be executed.
The actual control is via the breakpoint's description, 
which contains further constraints about when the breakpoint should stop and enter the debugger
(for example: constraints on the receiver, the thread, the count, etc.)

copyright
COPYRIGHT (c) 2006 by eXept Software AG
             All Rights Reserved

This software is furnished under a license and may be used
only in accordance with the terms of that license and with the
inclusion of the above copyright notice.   This software may not
be provided or otherwise made available to, or used by, any
other person.  No title to or ownership of the software is
hereby transferred.

Class protocol:

 method: aMethod position: characterPosition line: aLineNr

return an initialized instance

 new

return an initialized instance

 breakpointDescriptionClass

redefinable in subclasses

 breakpointsDisabled

 disableAllBreakpoints

global disabling of breakpoints (for miniDebugger)

 reenableAllBreakpoints

turn off the global disabling of breakpoints (for miniDebugger)

Instance protocol:

 description

 description: aBreakpointDescription

 icon
( an extension from the stx:libtool package )

 isReached

 isReached: aBoolean

 line

the lineNr

 line: lineArg

 method

 method: aMethod

 position

 position: anInteger

Modified (format): / 02-08-2012 / 09:26:03 / cg

 position: positionArg line: lineArg

 break

invoked by the breakPoint's code (see BreakPointNode),
which is compiled into the code as:
pushLit <theBreakpoint>
send0 #break

Usage example(s):

detect the break on the stack

 breakPointMessageForContext: sender

withoutLeadingSeparators

 initialize

Invoked when a new instance is created.

Usage example(s):

super initialize. -- commented since inherited method does nothing

 inspectorValueStringInListFor: anInspector

returns a string to be shown in the inspector's list

 printBreakpointNrInDebuggerOn: aStream

to be redefined for concrete debuggers
(some require a bpnt to be registered and use a handle or id to refer to them)

 printOn: aStream

append a printed representation of the receiver to the argument, aStream

 printPositionOrLineNumberOn: aStream

 beInvisible

make this breakpoint hidden (in gutter)

 beTracepoint

make this breakpoint a tracepoint

 disable

disable this breakpoint

 toggle

toggle this breakpoint

 toggleTracing

toggle tracing of this breakpoint

 isEnabled

Bad coding here, state should be full object

 isTracepoint

 isVisible