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

المراجعة الحالية بتاريخ 12:36، 9 سبتمبر 2018

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

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

fun compareTo(other: E): Int

حلت الدالة Comparable.compareTo()‎ مكان هذه الدالة.

المعاملات

`other`

الكائن الآخر المراد موازنته.

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

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

انظر أيضًا

الصنف Enum.
الدالة equals()‎: تتحقق إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Enum.compareTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Enum.compareTo()‎</code> في Kotlin}}</noinclude>
-تقارن الدالة<code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <nowiki/><nowiki/>.
+توازن الدالة <code>compareTo()‎</code> بين الكائن الذي استُدعي معها والكائن المُمرّر إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كان الكائن الأول (أي الذي استُدعي معها) أصغر من الكائن الثاني، أو قيمة موجبة إن كان الكائن الأول أكبر من الكائن الثاني.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-operator fun compareTo(other: Byte): Int
+fun compareTo(other: E): Int
-operator fun compareTo(other: Short): Int
-operator fun compareTo(other: Int): Int
-operator fun compareTo(other: Long): Int
-operator fun compareTo(other: Float): Int
-operator fun compareTo(other: Double): Int
-</syntaxhighlight>ويُلاحظ وجود الكلمة المفتاحيّة <code>operator</code> للدلالة على أنّ هذا التابع مرتبطٌ بمعامل التكرار (iteration operator).
-==القيمة المُعادة==
+</syntaxhighlight>حلت الدالة [[Kotlin/Comparable/compareTo|<code>Comparable.compareTo()‎</code>]] مكان هذه الدالة.
-قيمة عددية.
-==أمثلة==
+==المعاملات==
-===استخدام الدالة <code>()compareTo</code>===
-تعرّف الشيفرة الآتية عددين <nowiki/>باسم <code>x</code> و <code>y</code> ، ثم تستخدم الدالة<code>()compareTo</code> على x وتمرر <code>y</code>  كوسيط للمقارنة بينهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+=== <code>other</code> ===
-fun main(args: Array<String>) {
+الكائن الآخر المراد موازنته.
-    val x = 5
-    val y = 4
+==القيمة المعادة==
+تعاد القيمة 0 إن كانت القيمة المعطاة متساوية مع قيمة الوسيط <code>other</code>، أو تعاد قيمة سالبة إن كانت القيمة الأولى (القيمة المعطاة) أصغر من القيمة الثانية (قيمة الوسيط <code>other</code>)، أو تعاد قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
-    println(x.compareTo(y) )// 1
+==انظر أيضًا==
-}
+* الصنف <code>[[Kotlin/Enum|Enum]]</code>.
-</syntaxhighlight>
+* الدالة [[Kotlin/Enum/equals|<code>equals()</code>‎]]: تتحقق إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها.
-==أنظر أيضًا==
-* <code>[[Kotlin/Byte/dec|dec()]]</code>‎ : تخفض قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
-* <code>[[Kotlin/Byte/div|div()]]</code>‎ : تقوم  بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
-* <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
 ==مصادر==
-* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte/compare-to.html الدالة  Enum.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/compare-to.html صفحة الدالة Enum.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Functions]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Enum]]