الدالة Regex.containsMatchIn()‎ في Kotlin

تتحقق الدالة containsMatchIn()‎ إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه.

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

actual fun containsMatchIn(input: CharSequence): Boolean

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

تعاد القيمة true المنطقية إن بإمكان التعبير النمطي المعطى مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف input، أو تعاد القيمة false خلاف ذلك.

أمثلة

تنشئ الدالة Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة الأعداد، ثم تُستعمَل الدالة containsMatchIn()‎ مع ذلك التعبير النمطي لمعرفة إن كانت تحتوي مجموعةٌ من المحارف على أرقام أو أعداد:

fun main(args: Array<String>) {
    // يطابق التعبير النمطي التالي الأعداد
    val reg = Regex("""-?\d+(\.\d+)?""")

    val str1 = "abc123def"
    val str2 = "abcdefg!@#"

    print(reg.containsMatchIn(str1)) // true
    print(reg.containsMatchIn(str2)) // false

}

انظر أيضًا

• الخاصية pattern: تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

• الخاصية options: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر

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