الدالة regionMatches() في Kotlin
تتحقق الدالة regionMatches() من مطابقة جزأين من سلسلتين نصيتين أو سلسلتين من المحارف محددين ببداية وطول مع بعضهما بعضًا.
البنية العامة
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
المعاملات
thisOffset
عدد صحيح يمثل مقدار الإزاحة بدءًا من بداية سلسلة المحارف أو السلسلة النصية المعطاة والذي يحدد بداية الجزء المراد مطابقته.
other
سلسلة من المحارف أو سلسلة نصية تحوي الجزء المراد التحقق من مطابقته مع آخر موجود في سلسلة المحارف أو السلسلة النصية المعطاة.
otherOffset
عدد صحيح يمثل مقدار الإزاحة بدءًا من بداية سلسلة المحارف أو السلسلة النصية other والذي يحدد بداية الجزء المراد مطابقته.
length
عدد صحيح يمثل طول الجزأين المراد مطابقتهما مع بعضهما بعضًا.
ignoreCase
قيمة منطقية تحدد إن كان يراد تجاهل حالة المحارف أثناء الموازنة بينها أم لا. القيمة الافتراضية هي: false (أي أحذ حالة المحارف بالحسبان).
القيم المعادة
تعاد القيمة true إن تطابق الجزء المحدد بالبداية thisOffset والطول length في سلسلة المحارف أو السلسلة النصية المعطاة مع الجزء الآخر المحدد بالبداية otherOffset والطول length في سلسلة المحارف أو السلسلة النصية other. خلا ذلك، تعاد القيمة false.
أمثلة
مثالٌ على استعمال الدالة regionMatches():
fun main(args: Array<String>) {
val str1 = "abcradxyz"
val str2 = "mmradrt"
print(str1.regionMatches (3, str2, 2, 3)) // true
print(str1.regionMatches (3, str2, 1, 3)) // false
}
انظر أيضًا
- الدالة
contains(): تتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها. - الدالة
containsMatchIn(): تتحقق إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه. - الدالة
contentEquals(): تتحقق من تساوي محتوى السلسلة النصية التي استُدعيت معها مع محتوى سلسلة المحارف أو الكائنStringBufferالمُمرّر إليها. - الدالة
match(): تطابق التعبير النمطي المُمرّر إليها في السلسلة النصية التي استٌدعيت معها. - الدالة
matches(): تتحقق من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.