الفرق بين المراجعتين لصفحة: «Ruby/Module/const set»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>const_set | <noinclude>{{DISPLAYTITLE: التابع <code>Module.const_set</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby Module]] | [[تصنيف: Ruby Module Class]] | ||
يضبط التابع <code>const_set</code> قيمة | يضبط التابع <code>const_set</code> قيمة ثابت محدَّد إلى قيمة الكائن المعطى ثم يعيد ذلك الكائن. في حال لم يكن هناك ثابت يحمل الاسم المعطى، فسيُنشئ ثابت جديد ويسند إلى تلك القيمة. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">const_set(sym, obj) → obj | <syntaxhighlight lang="ruby">const_set(sym, obj) → obj | ||
| سطر 11: | سطر 9: | ||
==المعاملات== | ==المعاملات== | ||
===<code>sym</code>=== | ===<code>sym</code>=== | ||
رمز يمثل | [[Ruby/Symbol|رمز]] يمثل الثابت. إذا لم يكن المعامل <code>sym</code> اسم ثابت صالح، فسيُطلق الخطأ [[Ruby/NameError|<code>NameError</code>]] مع التحذير "wrong constant name". | ||
===<code>obj</code>=== | ===<code>obj</code>=== | ||
الكائن المراد ضبط قيمته إلى الثابت. | |||
===<code>str</code>=== | ===<code>str</code>=== | ||
سلسلة نصية تمثل الثابتة. | [[Ruby/String|سلسلة نصية]] تمثل الثابتة. إذا لم يكن المعامل <code>str</code> اسم ثابت صالح، فسيُطلق الخطأ <code>[[Ruby/NameError|NameError]]</code> مع التحذير "wrong constant name". | ||
==القيمة | ==القيمة المعادة== | ||
يعاد الكائن <code>obj</code>. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 27: | سطر 25: | ||
Math::HIGH_SCHOOL_PI - Math::PI #=> 0.00126448926734968</syntaxhighlight> | Math::HIGH_SCHOOL_PI - Math::PI #=> 0.00126448926734968</syntaxhighlight> | ||
==انظر أيضا== | ==انظر أيضا== | ||
* التابع <code>[[Ruby/Module/const_missing|const_missing]]</code>: يُستدعى | * التابع <code>[[Ruby/Module/const_missing|const_missing]]</code>: يُستدعى عند محاولة استخدام ثابت غير معرف في الوحدة. | ||
* التابع <code>[[Ruby/Module/constants|constants]]</code>:يعيد | * التابع <code>[[Ruby/Module/constants|constants]]</code>: يعيد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/Module.html#method-i-const_set قسم | *[http://ruby-doc.org/core-2.5.1/Module.html#method-i-const_set قسم التابع const_set في الصنف Module في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 11:52، 19 نوفمبر 2018
يضبط التابع const_set قيمة ثابت محدَّد إلى قيمة الكائن المعطى ثم يعيد ذلك الكائن. في حال لم يكن هناك ثابت يحمل الاسم المعطى، فسيُنشئ ثابت جديد ويسند إلى تلك القيمة.
البنية العامة
const_set(sym, obj) → obj
const_set(str, obj) → obj
المعاملات
sym
رمز يمثل الثابت. إذا لم يكن المعامل sym اسم ثابت صالح، فسيُطلق الخطأ NameError مع التحذير "wrong constant name".
obj
الكائن المراد ضبط قيمته إلى الثابت.
str
سلسلة نصية تمثل الثابتة. إذا لم يكن المعامل str اسم ثابت صالح، فسيُطلق الخطأ NameError مع التحذير "wrong constant name".
القيمة المعادة
يعاد الكائن obj.
أمثلة
مثال على استخدام التابع const_set:
Math.const_set("HIGH_SCHOOL_PI", 22.0/7.0) #=> 3.14285714285714
Math::HIGH_SCHOOL_PI - Math::PI #=> 0.00126448926734968
انظر أيضا
- التابع
const_missing: يُستدعى عند محاولة استخدام ثابت غير معرف في الوحدة. - التابع
constants: يعيد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء.