عرض مصدر Ruby/Module/const get

<noinclude>{{DISPLAYTITLE: التابع <code>Module.const_get‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Module Class]]
يتحقق التابع <code>const_get</code> من وجود ثابت باسم محدد في الوحدة التي استُدعي معها. في حال تعيين المعامل <code>inherit</code>، فسيشمل البحث الأسلاف أيضًا (وكذلك <code>[[Ruby/Object|Object]]</code> إن كانت الوحدة من النوع <code>[[Ruby/Module|Module]]</code>).

تُعاد قيمة الثابت إذا عُثر على تعريف له؛ خلا ذلك، سيُطلق الخطأ <code>[[Ruby/NameError|NameError]]</code>.<syntaxhighlight lang="ruby">
Math.const_get(:PI)   #=> 3.14159265358979

</syntaxhighlight>سيبحث التابع <code>const_get</code> بشكل تكراري (recursively) عن أسماء الثوابت إذا تم توفير اسم صنف من مجال أسماء (namespaced class name). اطلع مثلًا على المثال التالي:<syntaxhighlight lang="ruby">
module Foo; class Bar; end end
Object.const_get 'Foo::Bar'
</syntaxhighlight>تؤخذ الراية <code>inherit</code> بالحسبان عند كل عملية بحث:<syntaxhighlight lang="ruby">
module Foo
  class Bar
    VAL = 10
  end

  class Baz < Bar; end
end

Object.const_get 'Foo::Baz::VAL'         # => 10
Object.const_get 'Foo::Baz::VAL', false  # => NameError
</syntaxhighlight>إن لم يكن المعامل اسم ثابت صالح، فسيُطلق الخطأ <code>[[Ruby/NameError|NameError]]</code> مع الرسالة "wrong constant name".<syntaxhighlight lang="ruby">
Object.const_get 'foobar' #=> NameError: wrong constant name foobar

</syntaxhighlight>
==البنية العامة==
<syntaxhighlight lang="ruby">const_get(sym, inherit=true) → obj
const_get(str, inherit=true) → obj‎</syntaxhighlight>
==المعاملات==
===<code>sym‎</code>===
[[Ruby/Symbol|رمز]] يمثل الثابتة.
===<code>inherit‎</code>===
يحدد ما إذا كان يراد إجراء البحث بشكل تكراري (recursively).
===<code>str‎</code>===
[[Ruby/String|سلسلة نصية]] تمثل الثابتة.
==القيمة المعادة==
تُعاد قيمة الثابت إذا عُثر على تعريف له.
==أمثلة==
مثال على استخدام التابع <code>const_get‎</code>:<syntaxhighlight lang="ruby">Math.const_get(:PI)   #=> 3.14159265358979‎</syntaxhighlight>
==انظر أيضا==
*التابع <code>[[Ruby/Module/const defined-3F|const_defined?‎]]</code>: يتحقق  مما إذا كانت للوحدة  أو أحد أسلافها (ancestors) ثابت بالاسم المعطى.
*التابع <code>[[Ruby/Module/const missing|const_missing]]</code>: يُستدعى  عند محاولة استخدام ثابت غير معرف في الوحدة.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Module.html#method-i-const_get قسم التابع const_get‎ في الصنف Module‎ في توثيق روبي الرسمي.]