الخاصية MatchResult.range
في لغة Kotlin
تعيد الخاصية range
مجال الفهارس الذي يحدد مكان مُطابقة التعبير النمطي.
البنية العامة
abstract val range: IntRange
القيمة المعادة
كائن من النوع IntRange.
أمثلة
استخدام الخاصية range
في الشيفرة التالية ننشِئ تعبيرًا نمطيًا باسم regex
باستخدام التابع Regex()
، ثم نعرّف سلسلة نصية باسم str
، ثم نستخرج من str
مجموعات النتائج عبر استدعاء الدالة matchEntire()
، ثم نستخدم الخاصية range
لاستخراج مجال فهارس مُطابقة التعبير النمطيregex
الموجودة في str
، ثم نطبع الناتج:
fun main(args: Array<String>) {
val pattern = Regex("[a-zA-Z]+([0-9]+)[a-zA-Z]+([0-9]+)[a-zA-Z]+")
val str = "ABcDEFG12345DiFKGLSG938SDsFSd"
val res = pattern.matchEntire(str)?.range
print(res) // 0..28
}
أنظر أيضًا
- الخاصية
MatchResult.destructured
: تعيد نسخة من الصنفMatchResult.Destructured،
والتي توفّر مركبات لتفكيك قيم المجموعة المُطابقة. المركبة الأولى تقابل قيمة المجموعة المُطابقَة الأولى، والمركبة الثانية تقابل الثانية، وهكذا دواليك. - الخاصية
MatchResult.groupValues
: تعيد لائحة تضم مجموعة المُطابقات للتعبير النمطي. حجم تلك اللائحة يساويgroupCount + 1،
حيثgroupCount
هو عدد المجموعات المطابَقة في التعبير النمطي. تلك المجموعات مُفهرسة من 1 حتىgroupCount،
والمجموعة ذات الفهرس0
توافق المطابقة الكلية.
- الخاصية
MatchResult.groups
: تعيد الخاصيةgroups
كائنًا من النوعMatchGroupCollection
يضم مجموعة المُطابقات الموجودة فيالتعبير النمطي. حجم تلك المجموعة يساويgroupCount + 1،
حيثgroupCount
هو عدد المجموعات المطابَقة في التعبير النمطي. تلك المجموعات مُفهرسة من 1 حتىgroupCount،
والمجموعة ذات الفهرس0
توافق المطابقة الكلية.