عرض مصدر Ruby/Exception/backtrace

{{DISPLAYTITLE:التابع <code>Exception.backtrace</code> في روبي}}
يعيد التّابع <code>backtrace</code> أيَّ تتبع عكسي (backtrace) مرتبط بالاستثناء.

التتبع العكسي (backtrace) هو مصفوفةٌ من السّلاسل النصية، تحوي كل واحدةٍ منها إمّا "filename:lineNo: in 'method'‎<nowiki>''</nowiki> أو ".filename:lineNo<nowiki>''</nowiki>.

== البنية العامة ==
<syntaxhighlight lang="ruby">
backtrace → array
</syntaxhighlight>

== القيم المعادة ==
تُعاد مصفوفة تمثل التتبع العكسي.

== أمثلة ==
مثالٌ عن استخدام التابع <code>backtrace</code>:<syntaxhighlight lang="ruby">
def a
  raise "boom"
end

def b
  a()
end

begin
  b()
rescue => detail
  print detail.backtrace.join("\n")
end

</syntaxhighlight>سيعطي هذا المثال عند تنفيذه الناتج التالي:<syntaxhighlight lang="ruby">
prog.rb:2:in `a'
prog.rb:6:in `b'
prog.rb:10

</syntaxhighlight>

== انظر أيضا ==
* التابع <code>[[Ruby/Exception/backtrace locations|backtrace_locations]]</code>: يُعيد أي تتبع عكسي (backtrace) مرتبط بالاستثناء.
* التابع <code>[[Ruby/Exception/set backtrace|set_backtrace]]</code>: يضبط معلومات المصفوفة <code>backtrace</code> الخاصة بكائن الاستثناء.
* التابع <code>[[Ruby/Exception/exception|exception]]</code>: يُعيد المُستقبل (receiver).

== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Exception.html#method-i-backtrace صفحة التابع backtrace في الصنف Exception في توثيق روبي الرسمي.]
[[تصنيف:Ruby]]
[[تصنيف:Ruby Method]]
[[تصنيف:Ruby Exception]]