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

مراجعة 22:03، 25 يونيو 2018

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

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

abstract operator fun compareTo(other: T): Int

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

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

قيمة عددية.

أنظر أيضًا

صفحة النوع Comparable‎.

مصادر

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

@@ سطر 3: / سطر 3: @@
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-operator fun compareTo(other: Byte): Int
+abstract operator fun compareTo(other: T): 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).
 ==القيمة المُعادة==
 قيمة عددية.
-==أمثلة==
-===استخدام الدالة <code>()compareTo</code>===
+== أنظر أيضًا ==
-تعرّف الشيفرة الآتية عددين <nowiki/>باسم <code>x</code> و <code>y</code> ، ثم تستخدم الدالة<code>()compareTo</code> على x وتمرر <code>y</code>  كوسيط للمقارنة بينهما، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
-fun main(args: Array<String>) {
+* صفحة النوع <code>[[Kotlin/DeprecationLevel/index|Comparable]]</code>‎.
-    val x = 5
-    val y = 4
-    println(x.compareTo(y) )// 1
-}
-</syntaxhighlight>
-==أنظر أيضًا==
-* <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 الدالة  Comparable.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-comparable/compare-to.html الدالة  Comparable.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Functions]]