الخاصية MatchResult.destructured‎ في لغة Kotlin

تعيد الخاصية destructured‎ فهرس أول مطابقة للتعبير النمطي الذي استُدعيت عبره في الوسيط المُمرّر input،بداية من الفهرس المحدد بالوسيط startIndex.

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

actual fun find(
    input: CharSequence, 
    startIndex: Int = 0
): MatchResult?

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

عدد صحيح.

أمثلة

استخدام الخاصية destructured‎

ينشِئ التابع Regex()‎ في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة destructured‎ ويحيل القيمة المعادة إلى المتغير matchResult، ثم يطبع قيمة الفهرس:

fun main(args: Array<String>) {
 val reg = """-?\d+(\.\d+)?""".toRegex()

 val matchResult = reg.find("aff4rb")
    
 print(matchResult?.value) // 4
}

أنظر أيضًا

• الخاصية pattern: تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

• الخاصية options: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر

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