الفرق بين المراجعتين لصفحة: «Ruby/Module/const get»

مراجعة 22:30، 26 أكتوبر 2018

يتحقق التابع const_get من وجود ثابت (بالاسم المحدد) في الوحدة التي استُدعي معها. في حال تعيين الوسيط inherit، فسيشمل البحث الأسلاف أيضًا (وكذلك Object إن كانت الوحدة من النوع Module).

تُعاد قيمة الثابت إذا عُثر على تعريف لتلك الثابتة، خلا ذلك، سيُطلق الخطأ NameError.

Math.const_get(:PI)   #=> 3.14159265358979

سيبحث التابع const_get عوديًا (recursively) عن أسماء الثوابت إذا تم توفير اسم صتف مربوط (namespaced class name). مثلا:

module Foo; class Bar; end end
Object.const_get 'Foo::Bar'

تُحترم الراية inherit عند كل بحث. مثلا:

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

إن لم يكن الوسيط اسم ثابت صالح، فسيُطلق الخطأ NameError مع التحذير "wrong constant name".

Object.const_get 'foobar' #=> NameError: wrong constant name foobar

البنية العامة

const_get(sym, inherit=true) → obj
const_get(str, inherit=true) → obj‎

المعاملات

`sym‎`

رمز يمثل الثابتة.

`inherit‎`

يحدد ما إذا كان البحث عوديًا (recursively).

`str‎`

سلسلة نصية تمثل الثابتة.

القيمة المُعادة

تُعاد قيمة الثابت إذا عُثر على تعريف له،

أمثلة

مثال على استخدام التابع const_get‎:

Math.const_get(:PI)   #=> 3.14159265358979‎

انظر أيضا

التابع const_defined?‎: يتحقق مما إذا كانت للوحدة أو أحد أسلافها (ancestors) ثابت بالاسم المعطى
التابع const_missing: يُستدعى عند محاولة استخدام ثابت غير معرف في الوحدة.

مصادر

قسم التابع const_get‎ في الصنف Module‎ في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Module]]
-يتحقق التابع <code>const_get</code> من وجود ثابت بالاسم المحدد في الوحدة الذي استُدعي معه. في حال تعيين <code>inherit</code>، فسيشمل البحث الأسلاف أيضًا (وكذلك <code>Object</code> إن كانت الوحدة من النوع <code>Module</code>).
+يتحقق التابع <code>const_get</code> من وجود ثابت (بالاسم المحدد) في الوحدة التي استُدعي معها. في حال تعيين الوسيط <code>inherit</code>، فسيشمل البحث الأسلاف أيضًا (وكذلك <code>Object</code> إن كانت الوحدة من النوع <code>Module</code>).
-تُعاد قيمة الثابت إذا عُثر على تعريف ، خلا ذلك، سيُطلق <code>NameError</code>.
-سيبحث التابع <code>const_get</code> عوديًا (recursively) عن أسماء الثوابت إذا تم توفير اسم صتف مربوط (namespaced class name).  مثلا:
+تُعاد قيمة الثابت إذا عُثر على تعريف لتلك الثابتة، خلا ذلك، سيُطلق الخطأ <code>NameError</code>.<syntaxhighlight lang="ruby">
+Math.const_get(:PI)   #=> 3.14159265358979
-تُحترم الراية <code>inherit</code> عند كل بحث.  مثلا:
+</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>NameError</code> مع التحذير "wrong constant name".<syntaxhighlight lang="ruby">
+Object.const_get 'foobar' #=> NameError: wrong constant name foobar
+</syntaxhighlight>
-إن لم يكن الوسيط اسم ثابت صالح، فسيُطلق الخطأ <code>NameError</code> مع التحذير "wrong constant name".
 ==البنية العامة==
 <syntaxhighlight lang="ruby">const_get(sym, inherit=true) → obj
@@ سطر 16: / سطر 34: @@
 ==المعاملات==
 ===<code>sym‎</code>===
+رمز يمثل الثابتة.
 ===<code>inherit‎</code>===
+يحدد ما إذا كان البحث عوديًا (recursively).
 ===<code>str‎</code>===
+سلسلة نصية تمثل الثابتة.
 ==القيمة المُعادة==
+تُعاد قيمة الثابت إذا عُثر على تعريف له،
 ==أمثلة==
@@ سطر 28: / سطر 49: @@
 <syntaxhighlight lang="ruby">Math.const_get(:PI)   #=> 3.14159265358979‎</syntaxhighlight>
 ==انظر أيضا==
-* التابع <code>[[Ruby/Module/const_defined-3F|const_defined?]]</code>: يتحقق  مما إذا كانت للوحدة  أو أحد أسلافها (ancestors) ثابت بالاسم المعطى:
+* التابع <code>[[Ruby/Module/const_defined-3F|const_defined?‎]]</code>: يتحقق  مما إذا كانت للوحدة  أو أحد أسلافها (ancestors) ثابت بالاسم المعطى
-* التابع <code>[[Ruby/Module/const_missing|const_missing]]</code>: يُستدعى  عند محاولة استخدام ثابت غير معرف في الوحدة. يُمرّر إليه رمز sym  يمثل الثابتة غير المعرفة، ويعيد قيمة ليتم استخدامها بدل ذلك الثابت. الشيفرة التالية مثال على ذلك:
+* التابع <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‎ في توثيق روبي الرسمي.]