Class: IRB::Frame
Relationships & Source Files | |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
Exception2MessageMapper
|
|
Inherits: | Object |
Defined in: | lib/irb/frame.rb |
Constant Summary
-
CALL_STACK_OFFSET =
Default number of frames offset
3
-
INIT_STACK_TIMES =
Default number of stack frames
3
Class Method Summary
-
.bottom(n = 0)
Convenience method for #bottom
-
.new ⇒ Frame
constructor
Creates a new stack frame.
-
.sender
Returns the binding context of the caller from the last frame initialized.
-
.top(n = 0)
Convenience method for #top
Instance Method Summary
-
#bottom(n = 0)
Returns the
n
number of frames on the call stack from the first frame initialized. -
#top(n = 0)
Returns the
n
number of frames on the call stack from the last frame initialized. -
#trace_func(event, file, line, id, binding)
Used by
Kernel.set_trace_func
to register each event in the call stack.
Constructor Details
.new ⇒ Frame
Creates a new stack frame
# File 'lib/irb/frame.rb', line 27
def initialize @frames = [TOPLEVEL_BINDING] * INIT_STACK_TIMES end
Class Method Details
.bottom(n = 0)
Convenience method for #bottom
# File 'lib/irb/frame.rb', line 62
def Frame.bottom(n = 0) @backtrace.bottom(n) end
.sender
Returns the binding context of the caller from the last frame initialized
# File 'lib/irb/frame.rb', line 72
def Frame.sender eval "self", @backtrace.top end
.top(n = 0)
Convenience method for #top
# File 'lib/irb/frame.rb', line 67
def Frame.top(n = 0) @backtrace.top(n) end
Instance Method Details
#bottom(n = 0)
Returns the n
number of frames on the call stack from the first frame initialized.
Raises FrameOverflow if there are no frames in the given stack range.
# File 'lib/irb/frame.rb', line 55
def bottom(n = 0) bind = @frames[n] Fail FrameOverflow unless bind bind end
#top(n = 0)
Returns the n
number of frames on the call stack from the last frame initialized.
Raises FrameUnderflow if there are no frames in the given stack range.
# File 'lib/irb/frame.rb', line 45
def top(n = 0) bind = @frames[-(n + CALL_STACK_OFFSET)] Fail FrameUnderflow unless bind bind end
#trace_func(event, file, line, id, binding)
Used by Kernel.set_trace_func
to register each event in the call stack
# File 'lib/irb/frame.rb', line 32
def trace_func(event, file, line, id, binding) case event when 'call', 'class' @frames.push binding when 'return', 'end' @frames.pop end end