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

تعيد الدالة commonPrefixWith()‎ أكبر سابقة (prefix) مُشتركة بين سلسلة الحروف التي استُدعيت عبرها وسلسلة الحروف المُمرّرة، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما سابقة مشتركة فستعيد سلسلة نصية فارغة. 

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

fun CharSequence.commonPrefixWith(
    other: CharSequence, 
    ignoreCase: Boolean = false
): String

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

سلسلة نصية.

أمثلة

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

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

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

    println(str.commonPrefixWith("win64")) // => win 
}

انظر أيضًا

• commonSuffixWith()‎: تعيد أكبر لاحقة (suffix) مُشتركة بين سلسلة الحروف التي استُدعيت عبرها وسلسلة الحروف المُمرّرة، وفي حال إعطاء القيمة true للوسيط ignoreCase فستتجاهل الدالة حالة الحروف (لن تفرّق بين الحروف الكبيرة والصغيرة). الدالة أيضًا لا تُقسّم الأزواج البديلة (surrogate pairs)، وإن لم تكن بينهما لاحقة مشتركة فستعيد سلسلة نصية فارغة. 

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

مصادر

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