الفرق بين المراجعتين ل"Ruby/Module/const set"

من موسوعة حسوب
< Ruby‏ | Module
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق.)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>const_set‎</code> الخاص بالصنف <code>Module</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>Module.const_set‎</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Module]]
+
[[تصنيف: Ruby Module Class]]
يضبط التابع <code>const_set</code> قيمة الثابت المعطى <code>sym</code> عند الكائن المحدد <code>obj</code>، ثم يعيد ذلك الكائن. في حال لم يكن هناك ثابت يحمل الاسم المعطى، فسيُنشئ ثابتة جديدة.
+
يضبط التابع <code>const_set</code> قيمة ثابت محدَّد إلى قيمة الكائن المعطى ثم يعيد ذلك الكائن. في حال لم يكن هناك ثابت يحمل الاسم المعطى، فسيُنشئ ثابت جديد ويسند إلى تلك القيمة.
 
 
إذا لم يكن <code>sym</code> أو <code>str</code> أسماء ثوابت صالحة، فسيُطلق الخطأ <code>NameError</code> مع التحذير "wrong constant name".
 
 
==البنية العامة==
 
==البنية العامة==
 
<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>const_set</code> الكائن <code>obj‎</code>.  
+
يعاد الكائن <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 قسم التابع const_set‎ في الصنف Module‎ في توثيق روبي الرسمي.]
+
*[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: يعيد مصفوفة من أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء.

مصادر