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

تتحقق الدالة matches()‎ من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.

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

infix actual fun matches(input: CharSequence): Boolean

وجود الكلمة المفتاحية infix يدل على إمكانية استدعاء الدالة بنمط التدوين الداخلي (Infix notation)؛ أي من خلال حذف المعامل . والأقواس () المُستخدَمَين في الاستدعاء عادةً.

المعاملات

input

سلسلة من المحارف التي يراد أن يُتحقَق من مطابقتها كلِّيًا لتعبير نمطي معين.

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

تعاد القيمة true إن تطابقت جميع محارف السلسلة input مع التعبير النمطي المعطى.

أمثلة

استعمال الدالة matches()‎ للتحقق من مطابقة سلسلتين من المحارف مع التعبير النمطي reg:

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

انظر أيضًا

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

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

مصادر

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