kotovalexarian-likes-github/ruby--ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
Code Releases Activity

* iseq.c (RubyVM::InstructionSequence): Add rdoc for new iseq features

Browse source 
added from r38085, this includes ::of, #path, #absolute_path,
  #label, #base_label, #first_lineno, and #inspect


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@38650 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
zzak 2012-12-29 06:29:47 +00:00
parent 4706171d27
commit 1ddf183353
2 changed files with 127 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
ChangeLog
View file

@ -1,3 +1,9 @@
Sat Dec 29 15:28:00 2012 Zachary Scott <zachary@zacharyscott.net>
* iseq.c (RubyVM::InstructionSequence): Add rdoc for new iseq features
added from r38085, this includes ::of, #path, #absolute_path,
#label, #base_label, #first_lineno, and #inspect
Sat Dec 29 14:06:00 2012 Zachary Scott <zachary@zacharyscott.net>
* iseq.c (rb_iseq_line_trace_all, rb_iseq_line_trace_specify): Add

122
iseq.c
View file

@ -787,7 +787,8 @@ iseq_eval(VALUE self)
}
/*
* :nodoc:
* Returns a human-readable string representation of this instruction
* sequence, including the #label and #path.
*/
static VALUE
iseq_inspect(VALUE self)
@ -803,6 +804,27 @@ iseq_inspect(VALUE self)
RSTRING_PTR(iseq->location.label), RSTRING_PTR(iseq->location.path));
}
/*
* Returns the path of this instruction sequence.
*
* For example, using irb:
*
* ins = RubyVM::InstructionSequence.compile('num = 1 + 2')
* #=> <RubyVM::InstructionSequence:<compiled>@<compiled>>
* ins.path
* #=> "<compiled>"
*
* Using ::compile_file:
*
* # /tmp/method.rb
* def hello
* puts "hello, world"
* end
*
* # in irb
* > ins = RubyVM::InstructionSequence.compile_file('/tmp/method.rb')
* > ins.path #=> /tmp/method.rb
*/
static VALUE
iseq_path(VALUE self)
{
@ -811,6 +833,20 @@ iseq_path(VALUE self)
return iseq->location.path;
}
/*
* Returns the absolute path of this instruction sequence.
*
* For example, using ::compile_file:
*
* # /tmp/method.rb
* def hello
* puts "hello, world"
* end
*
* # in irb
* > ins = RubyVM::InstructionSequence.compile_file('/tmp/method.rb')
* > ins.absolute_path #=> /tmp/method.rb
*/
static VALUE
iseq_absolute_path(VALUE self)
{
@ -819,6 +855,26 @@ iseq_absolute_path(VALUE self)
return iseq->location.absolute_path;
}
/* Returns the label of this instruction sequence.
*
* For example, using irb:
*
* ins = RubyVM::InstructionSequence.compile('num = 1 + 2')
* #=> <RubyVM::InstructionSequence:<compiled>@<compiled>>
* ins.label
* #=> "<compiled>"
*
* Using ::compile_file:
*
* # /tmp/method.rb
* def hello
* puts "hello, world"
* end
*
* # in irb
* > ins = RubyVM::InstructionSequence.compile_file('/tmp/method.rb')
* > ins.label #=> <main>
*/
static VALUE
iseq_label(VALUE self)
{
@ -827,6 +883,26 @@ iseq_label(VALUE self)
return iseq->location.label;
}
/* Returns the base label of this instruction sequence.
*
* For example, using irb:
*
* ins = RubyVM::InstructionSequence.compile('num = 1 + 2')
* #=> <RubyVM::InstructionSequence:<compiled>@<compiled>>
* ins.base_label
* #=> "<compiled>"
*
* Using ::compile_file:
*
* # /tmp/method.rb
* def hello
* puts "hello, world"
* end
*
* # in irb
* > ins = RubyVM::InstructionSequence.compile_file('/tmp/method.rb')
* > ins.base_label #=> <main>
*/
static VALUE
iseq_base_label(VALUE self)
{
@ -835,6 +911,15 @@ iseq_base_label(VALUE self)
return iseq->location.base_label;
}
/* Returns the first line number of this instruction sequence.
*
* For example, using irb:
*
* ins = RubyVM::InstructionSequence.compile('num = 1 + 2')
* #=> <RubyVM::InstructionSequence:<compiled>@<compiled>>
* ins.first_lineno
* #=> 1
*/
static VALUE
iseq_first_lineno(VALUE self)
{
@ -1334,6 +1419,41 @@ rb_iseq_disasm(VALUE self)
return str;
}
/*
* Returns the instruction sequence containing the given proc or method.
*
* For example, using irb:
*
* # a proc
* > p = proc { num = 1 + 2 }
* > RubyVM::InstructionSequence.of(p)
* > #=> <RubyVM::InstructionSequence:block in irb_binding@(irb)>
*
* # for a method
* > def foo(bar); puts bar; end
* > RubyVM::InstructionSequence.of(method(:foo))
* > #=> <RubyVM::InstructionSequence:foo@(irb)>
*
* Using ::compile_file:
*
* # /tmp/iseq_of.rb
* def hello
* puts "hello, world"
* end
*
* $a_global_proc = proc { str = 'a' + 'b' }
*
* # in irb
* > require '/tmp/iseq_of.rb'
*
* # first the method hello
* > RubyVM::InstructionSequence.of(method(:hello))
* > #=> #<RubyVM::InstructionSequence:0x007fb73d7cb1d0>
*
* # then the global proc
* > RubyVM::InstructionSequence.of($a_global_proc)
* > #=> #<RubyVM::InstructionSequence:0x007fb73d7caf78>
*/
static VALUE
iseq_s_of(VALUE klass, VALUE body)
{