الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/compareTo»

من موسوعة حسوب
لا ملخص تعديل
ط استبدال النص - 'Kotlin Functions' ب'Kotlin Function'
سطر 29: سطر 29:
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/compare-to.html الدالة text.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/compare-to.html الدالة text.compareTo()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Functions]]
[[تصنيف:Kotlin Function]]

مراجعة 11:37، 30 أغسطس 2018

تقارن الدالة 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 والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.

مصادر