الدالة Regex.matches()‎ في لغة Kotlin

إن كانت جميع حروف الوسيط الممرّر input تطابق التعبير النمطي الذي استُدعيت عبره، فإن الدالةmatches()‎ تعيد نسخة من الصنف MatchResult تحتوي الكائن المُمرّر نفسه، وإلا فستعيد القيمة المعدومة null.

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

actual fun matchEntire(input: CharSequence): MatchResult?

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

كائن من النوع Sequence<MatchResult>‎ أو null.

أمثلة

استخدام التابع matches()‎

ينشِئ التابع Regex()‎ في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة matches()‎ لاختبار المطابقة الكلية لسلسلتين نصيتين للتعبير النمطي reg، ثم يطبع الناتج:

fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
    
println(reg.matchEntire("ab12cd34ef")?.value) // => null
println(reg.matchEntire("4564646")?.value) // => 4564646
}

أنظر أيضًا

• الخاصية pattern: تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
•  findAll()‎: تعيد كل المطابقات للتعبير النمطي الذي استُدعيت عبره في الوسيط المُمرّر input،بداية من الفهرس المحدد بالوسيط startIndex.

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

مصادر

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