الدالة text.compareTo()‎ في لغة Kotlin

تقارن الدالة compareTo()‎ بين سلسلتين نصيتين، مع إمكانية تجاهل حالة الأحرف عبر إعطاء القيمة true للوسيط ignoreCase.

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

fun String.compareTo(
    other: String, 
    ignoreCase: Boolean = false
): Int

يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).

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

عدد من النوع Int.

أمثلة

استخدام الدالة ()compareTo مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()compareTo عبرها مع تمرير سلسلة نصيةكوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
    val str = "abcd"

    println(str.compareTo("abch")) // => -4 
}

انظر أيضًا

• codePointAt()‎: تعيد كود اليونيكود (Unicode code point) للحرف الموجود في الفهرس المُحدّد.

• codePointBefore()‎: تعيد كود اليونيكود (Unicode code point) للحرف الموجود قبل الفهرس المُحدّد. 
• asSequence()‎: تنشئ كائنًا من الصنف Sequence والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر

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