From d585799d7303abeb1b0ca6fc868f0b2d76a26250 Mon Sep 17 00:00:00 2001 From: Jeremy Evans Date: Mon, 26 Apr 2021 15:21:52 -0700 Subject: Document binding behavior for C call/return events for TracePoint/set_trace_func C methods do not have bindings, so binding returns the binding of the nearest C method. Fixes [Bug #9009] --- trace_point.rb | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) (limited to 'trace_point.rb') diff --git a/trace_point.rb b/trace_point.rb index d68eed4248..2e85369e65 100644 --- a/trace_point.rb +++ b/trace_point.rb @@ -309,15 +309,21 @@ class TracePoint Primitive.tracepoint_attr_defined_class end - # Return the generated binding object from event + # Return the generated binding object from event. + # + # Note that for +c_call+ and +c_return+ events, the binding returned is the + # binding of the nearest Ruby method calling the C method, since C methods + # themselves do not have bindings. def binding Primitive.tracepoint_attr_binding end # Return the trace object during event # - # Same as TracePoint#binding: - # trace.binding.eval('self') + # Same as the following, except it returns the correct object (the method + # receiver) for +c_call+ and +c_return+ events: + # + # trace.binding.eval('self') def self Primitive.tracepoint_attr_self end -- cgit v1.2.3