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

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

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

fun String.matches(regex: String): Boolean 

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

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

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

قيمة منطقية.

أمثلة

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

تُعرّف الشيفرة الآتية سلسلتين نصيتين باسم str و str2، ثم تستدعي الدالة 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()‎: تعيد مصفوفة مكونة من السلاسل النصية المُطابقة للتعبير النمطي المُمرّر regex في السلسلة النصية التي استٌدعيت عبرها.
• mapIndexed()‎: تعيد لائحة مكونة من نتائج تطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.

مصادر

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