الفرق بين المراجعتين لصفحة: «Kotlin/Comparable/compareTo»

مراجعة 18:00، 13 أغسطس 2018

توازن الدالة compareTo()‎ بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.

البنية العامة

abstract operator fun compareTo(other: T): Int

وجود الكلمة المفتاحيّة operator يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).

القيمة المعادة

تعاد القيمة 0 إن كانت القيمة المعطاة متساوية مع قيمة الوسيط other، أو تعاد قيمة سالبة إن كانت القيمة الأولى (القيمة المعطاة) أصغر من القيمة الثانية (قيمة الوسيط other)، أو تعاد قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.

انظر أيضًا

الصنف Comparable‎.

مصادر

صفحة الدالة Comparable.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Comparable.compareTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Comparable.compareTo()‎</code> في Kotlin}}</noinclude>
-تقارن الدالة<code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <nowiki/><nowiki/>.
+توازن الدالة <code>compareTo()‎</code> بين الكائن الذي استُدعي معها والكائن المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
 abstract operator fun compareTo(other: T): Int
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
+</syntaxhighlight>وجود الكلمة المفتاحيّة <code>operator</code> يدل على أنّ هذا التابع مرتبطٌ بمعامل تكرار (iteration operator).
-==القيمة المُعادة==
+==القيمة المعادة==
-قيمة عددية.
+تعاد القيمة 0 إن كانت القيمة المعطاة متساوية مع قيمة الوسيط <code>other</code>، أو تعاد قيمة سالبة إن كانت القيمة الأولى (القيمة المعطاة) أصغر من القيمة الثانية (قيمة الوسيط <code>other</code>)، أو تعاد قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
-== أنظر أيضًا ==
+== انظر أيضًا ==
-* صفحة النوع <code>[[Kotlin/Comparable/index|Comparable]]</code>‎.
+* الصنف <code>[[Kotlin/Comparable|Comparable]]</code>‎.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-comparable/compare-to.html الدالة  Comparable.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-comparable/compare-to.html صفحة الدالة Comparable.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]