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

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

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

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

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

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

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

أمثلة

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

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

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

انظر أيضًا

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

مصادر

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