التابع text.regionMatches()‎ في لغة Kotlin

تعيد الدالة regionMatches()‎ القيمة true إن طابقَ الجزءُ الذي يبدأ بالفهرس thisOffset وطوله length من السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الجزءَ المُحددَ المقابل من العنصر المُمرّر other والذي يبدأ بالفهرس otherOffset وطوله length،

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

actual fun CharSequence.regionMatches(
    thisOffset: Int, 
    other: CharSequence, 
    otherOffset: Int, 
    length: Int, 
    ignoreCase: Boolean = false
): Boolean

fun String.regionMatches(
    thisOffset: Int, 
    other: String, 
    otherOffset: Int, 
    length: Int, 
    ignoreCase: Boolean = false
): Boolean

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

قيمة منطقية.

أمثلة

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

تُعرّف الشيفرة الآتية سلسلتين نصيتين باسم str و str2، ثم تستدعي الدالة regionMatches()‎ عبرهما وتمرّر عدة وسائط لتقارن بين جزئين منهما، ثم تطبع الناتج:

fun main(args: Array<String>) {
val str = "abcradxyz" 
val str2 = "mmradrt" 
    
print( str.regionMatches (3, str2, 2, 3) ) // true
print( str.regionMatches (3, str2, 1, 3) ) // false
}

انظر أيضًا

• match()‎: تعيد مصفوفة مكونة من السلاسل النصية المُطابقة للتعبير النمطي المُمرّر regex في السلسلة النصية التي استٌدعيت عبرها.
• matches()‎: تعيد الدالة matches()‎ القيمة true إن طابقت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها التعبير النمطي المُمرّر regex.

مصادر

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