الدالة matches()‎ في Kotlin

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

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

fun String.matches(regex: String): Boolean 

inline infix fun CharSequence.matches(regex: Regex): Boolean

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)).

المعاملات

regex

التعبير النمطي المراد التحقق من مطابقته مع السلسلة النصية المعطاة.

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

تعاد القيمة true إن طابق التعبير النمطي regex السلسلة النصية أو سلسلة المحارف التي استٌدعيت معها، أو تعاد القيمة false خلاف ذلك.

أمثلة

مثالٌ على استعمال الدالة matches()‎:

fun main(args: Array<String>) {
    val str = "sds12ff"
    val str2 = "sdsff"

    print(str.matches ("""-?\d+(\.\d+)?""")) // true
    print(str2.matches ("""-?\d+(\.\d+)?""")) // false
}

انظر أيضًا

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

مصادر

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