الدالة Regex.matches() في لغة Kotlin
إن كانت جميع حروف الوسيط الممرّر input تطابق التعبير النمطي الذي استُدعيت عبره، فإن الدالةmatches() ستعيد القيمة true، وإلا فستعيد false.
البنية العامة
infix actual fun matches(input: CharSequence): Boolean
يلاحظ وجود الكلمة المفتاحية infix والذي يدل على إمكانية استدعاء الدالة بنمط التدوين الداخلي (Infix notation)، أي من خلال حذف المعامل. والأقواس () المُستخدَمَين في الاستدعاء عادةً (للمزيد من التفاصيل راجع توثيق التدوين الداخلي).
القيمة المعادة
قيمة منطقية.
أمثلة
استخدام التابع matches()
ينشِئ التابع Regex() في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة 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:تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.