الدالة compareTo()‎ في Kotlin

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

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

fun compareTo(other: Boolean): Int (source)

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

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

أمثلة

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

fun main(args: Array<String>) {
    val x = "hsoub"
    val y = "academy"

    println(x.compareTo(y)) // 7
}

انظر أيضًا

• الدالة and()‎: تجري العملية and المنطقية بين قيمتين منطقيتين.
• الدالة or()‎ : تجري العملية or المنطقية بين قيمتين منطقيتين.
• الدالة not()‎: تعكس القيمة المنطقيَّة المستدعاة معها.
• الدالة xor()‎: تجري العملية xor المنطقية بين قيمتين منطقيتين.

مصادر

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