الفرق بين المراجعتين ل"Ruby/Comparable"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: المخلوط <code>Comparable</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Comparable يعيد التابع...')
 
ط
 
(3 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: المخلوط <code>Comparable</code> في روبي}}</noinclude>
 
<noinclude>{{DISPLAYTITLE: المخلوط <code>Comparable</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 +
[[تصنيف:Ruby Mixin]]
 
[[تصنيف: Ruby Comparable]]
 
[[تصنيف: Ruby Comparable]]
−
يعيد التابع ‎<code>clamp</code>‎الوسيط المُعطى <code>min</code> (أنظر فقرة البنية العامة) إن كان عائد <code>''obj'' <=> ''min''</code> ''أقل من <code>0</code>، أو يعيد <code>max</code> (أنظر فقرة البنية العامة) إن كان عائد <code>obj <=> max</code> أكبر  من <code>0</code>، خلا ذلك سيعيد الكائنَ <code>obj </code> الذي استدعي معه.''
+
يُستخدم المخلوط (mixin) ‏<code>Comparable</code> من قبل الأصناف التي يمكن ترتيب كائناتها. يجب أن يحدِّد الصنفُ المعاملَ <code><=></code>، الذي يوازن الكائن المستقبِل (receiver) مع كائن آخر، ويعيد ‎-1، أو 0، أو ‎+1 إن كان المُستقبِل أصغر من الكائن الآخر، أو يساويه، أو أكبر منه على التوالي. إذا كان الكائن الآخر غير قابل للموازنة، فعندئذ سيعيد المعامل <code><=></code> القيمة المعدومة <code>nil</code>.  
  
−
== البنية العامة ==
+
يستخدم <code>Comparable</code> المعامل <code><=></code> لإجراء عمليات الموازنة التقليدية (أي العمليات <code>[[Ruby/Comparable/Greater Than|>]]</code>، و ‎<code>[[Ruby/Comparable/Greater-3D|<=]]‎</code>، و <code>[[Ruby/Comparable/equal|==]]</code>، و <code>[[Ruby/Comparable/Less-3D|=<‎]]</code>، و <code>[[Ruby/Comparable/Less than|<]]</code>) والتابع [[Ruby/Comparable/between-3F|<code>between?</code>‎]].
−
<syntaxhighlight lang="ruby">
+
==توابع الكائن العامة (Public Instance Methods)==
−
clamp(min, max) → obj
+
===المعامل <code rel="mw:WikiLink" title="Ruby/Comparable/Greater-3D" href="Ruby/Comparable/Greater-3D">[[Ruby/Comparable/Greater-3D|=>]]</code>===
−
</syntaxhighlight>
+
 يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <code><=></code> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة <code>true</code> إن أعاد المعامل <code><=></code> القيمة ‎<code>-1</code>‎ أو <code>0</code>، وإلا فسيعيد القيمة <code>false</code>.
−
 
+
===المعامل <code rel="mw:WikiLink" title="Ruby/Comparable/equal" href="Ruby/Comparable/equal">[[Ruby/Comparable/equal|==]]</code>===
−
== المعاملات ==
+
يوازن بين كائنين ثمَّ يعيد القيمة <code>true</code> إن أعاد المعامل <code><=></code> القيمة <code>0</code> أي كان الكائنان متساويين؛ خلا ذلك، سيعيد القيمة <code>false</code>.
−
 
+
===المعامل <code rel="mw:WikiLink" title="Ruby/Comparable/Greater Than" href="Ruby/Comparable/Greater Than">[[Ruby/Comparable/Greater Than|>]]</code>===
−
=== <code>''min''</code> ===
+
يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <code><=></code> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة <code>true</code> إن أعاد المعامل <code><=></code> القيمة ‎<code>-1</code>‎، وإلا فسيعيد القيمة <code>false</code>.
−
يمثل هذا المعامل القيمة الدنيا.
+
===المعامل <code rel="mw:WikiLink" title="Ruby/Comparable/Less-3D" href="./Ruby/Comparable/Less-3D">[[Ruby/Comparable/Less-3D|‎‎‎>=‎]]</code>===
−
 
+
يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <code><=></code> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة <code>true</code> إن أعاد المعامل <code><=></code> القيمة <code>1</code> أو <code>0</code>، وإلا فسيعيد القيمة <code>false</code>.
−
=== <code>''max''</code>'' '' ===
+
===المعامل <code rel="mw:WikiLink" title="Ruby/Comparable/Less than" href="Ruby/Comparable/Less than">[[Ruby/Comparable/Less than|<]]</code>===
−
يمثل هذا المعامل القيمة القصوى.
+
يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <code><=></code> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة <code>true</code> إن أعاد المعامل <code><=></code> القيمة ‎<code>1</code>، وإلا فسيعيد القيمة <code>false</code>.
−
 
+
===التابع ‎[[Ruby/Comparable/clamp|<code>clamp</code>‎]]===
−
== القيمة المٌعادة ==
+
يعيد التابع ‎الوسيط المُعطى <code>min</code> (أنظر فقرة البنية العامة) إن كان عائد <code>obj <=> min</code> أقل من <code>0</code>، أو يعيد <code>max</code> (أنظر فقرة البنية العامة) إن كان عائد <code>obj <=> max</code> أكبر  من <code>0</code>، خلا ذلك سيعيد الكائنَ <code>obj </code> الذي استدعي معه.
−
يعيد التابع ‎<code>clamp</code>‎الوسيط المُعطى <code>min</code> إن كان عائد <code>''obj'' <=> ''min''</code> ''أقل من <code>0،</code> أو يعيد <code>max</code> إن كان عائد <code>obj <=> max</code> أكبر  من <code>0</code>، خلا ذلك سيعيد الكائن <code>obj </code> الذي استدعي معه.''
+
===التابع <code rel="mw:WikiLink" title="Ruby/Comparable/between-3F" href="./Ruby/Comparable/between-3F">‎[[Ruby/Comparable/between-3F|between?‎]]</code>===
−
 
+
يتحقق مما إذا كان الكائن الذي استُدعي معه محصورًا بين الكائنين المٌمرّرين إليه.
−
== أمثلة ==
+
==مصادر==
−
أمثلة عن استخدام التابع <code>clamp</code>‎:<syntaxhighlight lang="ruby">
+
*[http://ruby-doc.org/core-2.5.1/Comparable.html#method-i-between-3F قسم المخلوط Comparable في توثيق روبي الرسمي.]
−
12.clamp(0, 100)        #=> 12
 
−
523.clamp(0, 100)        #=> 100
 
−
-3.123.clamp(0, 100)    #=> 0
 
−
 
 
−
'd'.clamp('a', 'f')      #=> 'd'
 
−
'z'.clamp('a', 'f')      #=> 'f'
 
−
</syntaxhighlight>
 
−
 
 
−
== أنظر أيضًا ==
 
−
* التابع [[Ruby/Comparable/between-3F|‎<code>between?</code>]]‎ : يتحقق التابع ‎<code>between?</code>‎مما إذا كان الكائن الذي استُدعي معه محصورا بين الكائنين المٌمرّرين إليه.
 
−
 
 
−
== مصادر ==
 
−
* [http://ruby-doc.org/core-2.5.1/Comparable.html#method-i-between-3F قسم التابع <code>between?</code>‎ في الصنف Array في توثيق روبي الرسمي.]
 

المراجعة الحالية بتاريخ 12:26، 21 نوفمبر 2018

يُستخدم المخلوط (mixin) ‏Comparable من قبل الأصناف التي يمكن ترتيب كائناتها. يجب أن يحدِّد الصنفُ المعاملَ <=>، الذي يوازن الكائن المستقبِل (receiver) مع كائن آخر، ويعيد ‎-1، أو 0، أو ‎+1 إن كان المُستقبِل أصغر من الكائن الآخر، أو يساويه، أو أكبر منه على التوالي. إذا كان الكائن الآخر غير قابل للموازنة، فعندئذ سيعيد المعامل <=> القيمة المعدومة nil.

يستخدم Comparable المعامل <=> لإجراء عمليات الموازنة التقليدية (أي العمليات >، و ‎<=‎، و ==، و =<‎، و <) والتابع between?‎.

توابع الكائن العامة (Public Instance Methods)

المعامل =>

 يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة true إن أعاد المعامل <=> القيمة ‎-1‎ أو 0، وإلا فسيعيد القيمة false.

المعامل ==

يوازن بين كائنين ثمَّ يعيد القيمة true إن أعاد المعامل <=> القيمة 0 أي كان الكائنان متساويين؛ خلا ذلك، سيعيد القيمة false.

المعامل >

يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة true إن أعاد المعامل <=> القيمة ‎-1‎، وإلا فسيعيد القيمة false.

المعامل ‎‎‎>=‎

يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة true إن أعاد المعامل <=> القيمة 1 أو 0، وإلا فسيعيد القيمة false.

المعامل <

يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <=> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة true إن أعاد المعامل <=> القيمة ‎1، وإلا فسيعيد القيمة false.

التابع ‎clamp‎

يعيد التابع ‎الوسيط المُعطى min (أنظر فقرة البنية العامة) إن كان عائد obj <=> min أقل من 0، أو يعيد max (أنظر فقرة البنية العامة) إن كان عائد obj <=> max أكبر من 0، خلا ذلك سيعيد الكائنَ obj  الذي استدعي معه.

التابع ‎between?‎

يتحقق مما إذا كان الكائن الذي استُدعي معه محصورًا بين الكائنين المٌمرّرين إليه.

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Ruby/Comparable&oldid=24216"