الدالة Regex.matchEntire() في لغة Kotlin
إن كانت جميع حروف الوسيط الممرّر input تطابق التعبير النمطي الذي استُدعيت عبره، فإن الدالةmatchEntire() تعيد نسخة من الصنف MatchResult تحتوي الكائن المُمرّر نفسه، وإلا فستعيد القيمة المعدومة null.
البنية العامة
actual fun matchEntire(input: CharSequence): MatchResult?
القيمة المعادة
كائن من النوع Sequence<MatchResult> أو null.
أمثلة
استخدام التابع matchEntire()
ينشِئ التابع Regex() في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة matchEntire() لاختبار المطابقة الكلية لسلسلتين نصيتين للتعبير النمطي 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:تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.