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.47 date: 2019/07/09 13:23:45

user: cg

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 reciever, the thread, the count, etc.)

Class protocol:

 new

return an initialized instance

 breakpointDescriptionClass

redefinable in subclasses

 disableAllBreakpoints

Instance protocol:

 description

 description: aBreakpointDescription

 icon
( an extension from the stx:libtool package )

 isReached

 isReached: aBoolean

 line

the lineNr

 line: lineArg

 method: something

 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