الفرق بين المراجعتين ل"Kotlin/kotlin.text/MatchResult/range"
< Kotlin | kotlin.text | MatchResult
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الخاصية <code>MatchResult.range</code> في لغة Kotlin}}</noinclude> تعيد الخاصية <code>range</code> كائنًا من...') |
|||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: الخاصية <code>MatchResult.range</code> في لغة Kotlin}}</noinclude> | <noinclude>{{DISPLAYTITLE: الخاصية <code>MatchResult.range</code> في لغة Kotlin}}</noinclude> | ||
− | تعيد الخاصية <code>range</code> | + | تعيد الخاصية <code>range</code> مجال الفهارس الذي يحدد مكان مُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. |
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
− | abstract val | + | abstract val range: IntRange |
</syntaxhighlight> | </syntaxhighlight> | ||
==القيمة المُعادة== | ==القيمة المُعادة== | ||
− | كائن من النوع <code> | + | كائن من النوع <code>IntRange.</code> |
==أمثلة== | ==أمثلة== | ||
===استخدام الخاصية <code>range</code>=== | ===استخدام الخاصية <code>range</code>=== | ||
− | في الشيفرة التالية ننشِئ <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>regex</code> باستخدام التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]</code>، ثم نعرّف سلسلة نصية باسم <code>str</code>، ثم نستخرج من <code>str</code> مجموعات النتائج عبر استدعاء الدالة <code>matchEntire()</code>، ثم نستخدم الخاصية <code>range</code> لاستخراج | + | في الشيفرة التالية ننشِئ <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>regex</code> باستخدام التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]</code>، ثم نعرّف سلسلة نصية باسم <code>str</code>، ثم نستخرج من <code>str</code> مجموعات النتائج عبر استدعاء الدالة <code>matchEntire()</code>، ثم نستخدم الخاصية <code>range</code> لاستخراج مجال فهارس مُطابقة [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]<code>regex</code> الموجودة في <code>str</code>، ثم نطبع الناتج:<syntaxhighlight lang="kotlin"> |
fun main(args: Array<String>) { | fun main(args: Array<String>) { | ||
val pattern = Regex("[a-zA-Z]+([0-9]+)[a-zA-Z]+([0-9]+)[a-zA-Z]+") | val pattern = Regex("[a-zA-Z]+([0-9]+)[a-zA-Z]+([0-9]+)[a-zA-Z]+") | ||
val str = "ABcDEFG12345DiFKGLSG938SDsFSd" | val str = "ABcDEFG12345DiFKGLSG938SDsFSd" | ||
− | val res = pattern.matchEntire(str)?. | + | val res = pattern.matchEntire(str)?.range |
− | print(res) | + | |
+ | print(res) // 0..28 | ||
} | } | ||
− | |||
− | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==أنظر أيضًا== | ==أنظر أيضًا== | ||
* الخاصية <code>[[Kotlin/kotlin.text/MatchResult/destructured|MatchResult.destructured]]</code>: تعيد نسخة من الصنف <code>[[Kotlin/kotlin.text/MatchResult/Destructured/index|MatchResult.Destructured]]،</code> والتي توفّر مركبات لتفكيك قيم المجموعة المُطابقة. المركبة الأولى تقابل قيمة المجموعة المُطابقَة الأولى، والمركبة الثانية تقابل الثانية، وهكذا دواليك. | * الخاصية <code>[[Kotlin/kotlin.text/MatchResult/destructured|MatchResult.destructured]]</code>: تعيد نسخة من الصنف <code>[[Kotlin/kotlin.text/MatchResult/Destructured/index|MatchResult.Destructured]]،</code> والتي توفّر مركبات لتفكيك قيم المجموعة المُطابقة. المركبة الأولى تقابل قيمة المجموعة المُطابقَة الأولى، والمركبة الثانية تقابل الثانية، وهكذا دواليك. | ||
* الخاصية <code>[[Kotlin/kotlin.text/MatchResult/groupValues|MatchResult.groupValues]]</code>: تعيد [[Kotlin/List|لائحة]] تضم مجموعة المُطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]. حجم تلك [[Kotlin/List|اللائحة]] يساوي <code>groupCount + 1،</code> حيث<code>groupCount</code> هو عدد المجموعات المطابَقة في <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. تلك المجموعات مُفهرسة من 1 حتى <code>groupCount،</code> والمجموعة ذات الفهرس <code>0</code> توافق المطابقة الكلية. | * الخاصية <code>[[Kotlin/kotlin.text/MatchResult/groupValues|MatchResult.groupValues]]</code>: تعيد [[Kotlin/List|لائحة]] تضم مجموعة المُطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]. حجم تلك [[Kotlin/List|اللائحة]] يساوي <code>groupCount + 1،</code> حيث<code>groupCount</code> هو عدد المجموعات المطابَقة في <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]. تلك المجموعات مُفهرسة من 1 حتى <code>groupCount،</code> والمجموعة ذات الفهرس <code>0</code> توافق المطابقة الكلية. | ||
+ | |||
+ | * الخاصية <code>[[Kotlin/kotlin.text/MatchResult/groups|MatchResult.groups]]</code>: تعيد الخاصية <code>groups</code> كائنًا من النوع <code>MatchGroupCollection</code> يضم مجموعة المُطابقات الموجودة فيالتعبير النمطي. حجم تلك المجموعة يساوي <code>groupCount + 1،</code> حيث<code>groupCount</code> هو عدد المجموعات المطابَقة في التعبير النمطي. تلك المجموعات مُفهرسة من 1 حتى <code>groupCount،</code> والمجموعة ذات الفهرس <code>0</code> توافق المطابقة الكلية. | ||
==مصادر== | ==مصادر== | ||
− | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-match-result/ | + | * [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-match-result/range.html الخاصية MatchResult.range في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.] |
[[تصنيف:Kotlin]] | [[تصنيف:Kotlin]] | ||
[[تصنيف:Kotlin Property]] | [[تصنيف:Kotlin Property]] |
مراجعة 22:47، 6 يوليو 2018
تعيد الخاصية 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
توافق المطابقة الكلية.