الفرق بين المراجعتين ل"Kotlin/Byte/compareTo"

المراجعة الحالية بتاريخ 13:49، 8 سبتمبر 2018

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

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

operator fun compareTo(other: Byte): Int

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

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

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

المعاملات

`other`

العدد الآخر المراد الموازنة بينه وبين العدد المعطى.

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

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

أمثلة

استعمال الدالة ()compareTo للموازنة بين عددين:

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

انظر أيضًا

الدالة dec()‎: تُنقِص القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
الدالة inc()‎ : تزيد القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
الدالة div()‎: تقسِّم العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج.
الدالة minus()‎: تطرح العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج.
الدالة plus()‎: تجمع العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج.
الدالة rangeTo()‎: تنشئ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها.
الدالة rem()‎: تحسب باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها.
الدالة times()‎: تضرب العدد الممرّر إليها بالعدد المستدعى معها ثم تعيد الناتج.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.compareTo()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Byte.compareTo()‎</code> في Kotlin}}</noinclude>
-تقارن الدالة<code>compareTo()‎</code> بين قيمة العنصر الذي استُدعيت عبره والقيمة المُمرّرة، إذ تعيد القيمة <code>0</code> إن كانا متساويين، أو تعيد قيمة سلبية إن كانت قيمة العنصر الذي استُدعيت عبره أصغر من القيمة المُمرّرة، أو تعيد قيمة موجبة إن كانت قيمة العنصر الذي استُدعيت عبره أكبر من القيمة المُمرّرة <nowiki/><nowiki/>.
+توازن الدالة <code>compareTo()‎</code> بين قيمة العنصر الذي استُدعي معها والقيمة المُمرّرة إليها ثمَّ تعيد القيمة 0 إن كانا متساويين، أو قيمة سالبة إن كانت القيمة الأولى (قيمة العنصر الذي استُدعيت معه) أصغر من القيمة الثانية، أو قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-fun compareTo(other: Boolean): Int (source)
+operator fun compareTo(other: Byte): Int
-</syntaxhighlight>
+</syntaxhighlight>حلت الدالة [[Kotlin/Comparable/compareTo|<code>Comparable.compareTo()‎</code>]] مكان الشكل السابق من هذه الدالة.<syntaxhighlight lang="kotlin">
-==القيمة المُعادة==
+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>other</code> ===
+العدد الآخر المراد الموازنة بينه وبين العدد المعطى.
+==القيمة المعادة==
+تعاد القيمة 0 إن كانت القيمة المعطاة متساوية مع قيمة الوسيط <code>other</code>، أو تعاد قيمة سالبة إن كانت القيمة الأولى (القيمة المعطاة) أصغر من القيمة الثانية (قيمة الوسيط <code>other</code>)، أو تعاد قيمة موجبة إن كانت القيمة الأولى أكبر من القيمة الثانية.
 ==أمثلة==
-===استخدام الدالة <code>()compareTo</code>===
+استعمال الدالة <code>()compareTo</code> للموازنة بين عددين:<nowiki/><syntaxhighlight lang="kotlin">
-تعرّف الشيفرة الآتية  <nowiki/>[[Kotlin/String|سلسلتين نصيتين]] باسم <code>x</code> و <code>y</code> ، ثم تستخدم الدالة<code>()compareTo</code> على x وتمرر <code>y</code>  كوسيط للمقارنة بينهما، ثم تطبع الناتج:
-<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/Byte/dec|dec()‎]]</code>: تُنقِص القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
-*<code>[[Kotlin/Boolean/not|not()]]</code>‎ : تعيد نفي القيمة المنطقية.
+*الدالة <code>[[Kotlin/Byte/inc|inc()]]</code>‎ : تزيد القيمة التي استُدعيت معها بمقدار 1 ثم تعيد القيمة الناتجة.
+*الدالة <code>[[Kotlin/Byte/div|div()]]</code>‎: تقسِّم العدد الذي استُدعي معه على العدد الممرّر إليها ثم تعيد الناتج.
+*الدالة <code>[[Kotlin/Byte/minus|minus()‎]]</code>: تطرح العدد الممرّر إليها من العدد الذي استُدعي معها ثم تعيد الناتج.
+*الدالة <code>[[Kotlin/Byte/plus|plus()‎]]</code>: تجمع العدد الممرّر إليها مع العدد الذي استُدعي معها ثم تعيد الناتج.
+*الدالة <code>[[Kotlin/Byte/rangeTo|rangeTo()‎]]</code>: تنشئ مجالًا يقع بين القيمة التي استدعيت معها والقيمة المُمرّرة إليها.
+*الدالة <code>[[Kotlin/Byte/rem|rem()‎]]</code>: تحسب باقي عملية قسمة العدد الذي استُدعيت معه على العدد الممرّر إليها.
+*الدالة <code>[[Kotlin/Byte/times|times()‎]]</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]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Byte]]