Kotlin/Double/compareTo

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

استُبدِل بهذه الدالة الدالة Comparable.compareTo()‎.

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

operator fun compareTo(other: Byte): Int (source)
operator fun compareTo(other: Short): Int (source)
operator fun compareTo(other: Int): Int (source)
operator fun compareTo(other: Long): Int (source)
operator fun compareTo(other: Float): Int (source)
operator fun compareTo(other: Double): Int (source)

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

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

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

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

أمثلة

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

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

انظر أيضًا

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

مصادر

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