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

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

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

actual fun containsMatchIn(input: CharSequence): Boolean

المعاملات

input

سلسلة المحارف التي يراد التحقق من تطابق أحد محارفها -على الأقل- مع التعبير النمطي المعطى.

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

تعاد القيمة 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

}

انظر أيضًا

• الدالة find()‎: تبحث عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
• الدالة matches()‎: تتحقق من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها. 
• الدالة matchEntire()‎: تحاول مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.
• الدالة replace()‎: تبدل سلسلة النصية معينة مكان كل تطابقات التعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها أو سلسلة المحارف التي تعيدها الدالة الممررة إليها.

مصادر

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