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

تعيد الدالة compareTo()‎ عدد أكواد اليونيكود (Unicode code point) في المجال المُحدّد من النص.

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

inline fun String.codePointCount(
    beginIndex: Int, 
    endIndex: Int
): Int

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

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

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

أمثلة

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

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

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

    println(str.codePointCount(2,8)) // => 6 
}

انظر أيضًا

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

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

مصادر

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