عرض مصدر Ruby/Comparable

<noinclude>{{DISPLAYTITLE: المخلوط <code>Comparable</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف:Ruby Mixin]]
[[تصنيف: Ruby Comparable]]
يُستخدم المخلوط (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>‎]].
==توابع الكائن العامة (Public Instance Methods)==
===المعامل <code rel="mw:WikiLink" href="Ruby/Comparable/Greater-3D" title="Ruby/Comparable/Greater-3D">[[Ruby/Comparable/Greater-3D|=>]]</code>===
 يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <code><=></code> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة <code>true</code> إن أعاد المعامل <code><=></code> القيمة ‎<code>-1</code>‎ أو <code>0</code>، وإلا فسيعيد القيمة <code>false</code>.
===المعامل <code rel="mw:WikiLink" href="Ruby/Comparable/equal" title="Ruby/Comparable/equal">[[Ruby/Comparable/equal|==]]</code>===
يوازن بين كائنين ثمَّ يعيد القيمة <code>true</code> إن أعاد المعامل <code><=></code> القيمة <code>0</code> أي كان الكائنان متساويين؛ خلا ذلك، سيعيد القيمة <code>false</code>.
===المعامل <code rel="mw:WikiLink" href="Ruby/Comparable/Greater Than" title="Ruby/Comparable/Greater Than">[[Ruby/Comparable/Greater Than|>]]</code>===
يوازن بين كائنين بناءً على النتيجة التي يعيدها المعامل <code><=></code> الخاص بالمُستقبِل (receiver)، إذ يعيد القيمة <code>true</code> إن أعاد المعامل <code><=></code> القيمة ‎<code>-1</code>‎، وإلا فسيعيد القيمة <code>false</code>.
===المعامل <code rel="mw:WikiLink" href="./Ruby/Comparable/Less-3D" title="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 rel="mw:WikiLink" href="Ruby/Comparable/Less than" title="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 rel="mw:WikiLink" href="./Ruby/Comparable/between-3F" title="Ruby/Comparable/between-3F">‎[[Ruby/Comparable/between-3F|between?‎]]</code>===
يتحقق مما إذا كان الكائن الذي استُدعي معه محصورًا بين الكائنين المٌمرّرين إليه.
==مصادر==
*[http://ruby-doc.org/core-2.5.1/Comparable.html#method-i-between-3F قسم المخلوط Comparable في توثيق روبي الرسمي.]