Kotlin/kotlin.text/matches

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

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

inline fun String.match(regex: String): Array<String>?

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

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

مصفوفة مكونة من سلاسل نصية.

أمثلة

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

تُعرّف الشيفرة الآتية سلسلة نصية باسم str، ثم تستدعي الدالة matches()‎ عبرها وتمرر سلسلة نصية كوسيط، ثم تطبع الناتج:

fun main(args: Array<String>) {
val str = "sds12ff" 
    
print( str.match("""-?\d+(\.\d+)?""") ) // 12,
}

انظر أيضًا

• mapTo()‎: تضيف إلى المجموعة المتغيرة المُمرّرة destination نتائج تطبيق الدالة transform على عناصر سلسلة الحروف التي استٌدعيت عبرها.
• mapIndexed()‎: تعيد لائحة مكونة من نتائج تطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.

مصادر

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