الدالة 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:تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.