الفرق بين المراجعتين لصفحة: «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»