الدالة MatchResult.next() في لغة Kotlin
تعيد الدالةnext() كائنًا من النوع MatchResult يحتوي نتائج المطابقة الموالية للتعبير النمطي، بداية من فهرس آخر مطابقة.
البنية العامة
abstract fun next(): MatchResult?
القيمة المُعادة
كائنًا من النوع MatchResult.
أمثلة
استخدام التابع next()
ينشِئ التابع Regex() في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة find() للحصول على مطابقات التعبير النمطي reg في السلسلة النصية المُمرّرة، ويحيل القيمة المعادة (43) إلى المتغير matchResult، ثم يستدعي الدالة next() عبر matchResult للحصول على المطابقة الموالية (24)، ثم يطبع النتائج:
fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""")
val matchResult = reg.find("xab43cd24y")
val nextMatchResult = matchResult?.next()
print(matchResult?.value) // 43
print(nextMatchResult?.value) // 24
}
أنظر أيضًا
- لخاصية
MatchResult.destructured: تعيد نسخة من الصنفMatchResult.Destructured،والتي توفّر مركبات لتفكيك قيم المجموعة المُطابقة. المركبة الأولى تقابل قيمة المجموعة المُطابقَة الأولى، والمركبة الثانية تقابل الثانية، وهكذا دواليك. - الخاصية
MatchResult.groupValues: تعيد لائحة تضم مجموعة المُطابقات للتعبير النمطي. حجم تلك اللائحة يساويgroupCount + 1،حيثgroupCountهو عدد المجموعات المطابَقة في التعبير النمطي. تلك المجموعات مُفهرسة من 1 حتىgroupCount،والمجموعة ذات الفهرس0توافق المطابقة الكلية. - الخاصية
MatchResult.groups: تعيد الخاصيةgroupsكائنًا من النوعMatchGroupCollectionيضم مجموعة المُطابقات الموجودة فيالتعبير النمطي. حجم تلك المجموعة يساويgroupCount + 1،حيثgroupCountهو عدد المجموعات المطابَقة في التعبير النمطي. تلك المجموعات مُفهرسة من 1 حتىgroupCount،والمجموعة ذات الفهرس0توافق المطابقة الكلية.