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

مراجعة 23:19، 24 يونيو 2018

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

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

operator fun compareTo(other: Byte): 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

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

قيمة عددية.

أمثلة

استخدام الدالة `()compareTo`

تعرّف الشيفرة الآتية عددين باسم x و y ، ثم تستخدم الدالة()compareTo على x وتمرر y كوسيط للمقارنة بينهما، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val x = 5
    val y = 4
    
    println(x.compareTo(y) )// 1
}

أنظر أيضًا

or()‎ : تقوم بالعملية المنطقة or بين قيمتين منطقيتين، وعلى خلاف المعامل ||، فهذه الدالة تتحقق من كلا القيمتين المنطقيتين.

مصادر

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

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