الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/MatchResult/groupValues»
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
تعيد الخاصية <code>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>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> توافق المطابقة الكلية. | ||
إن كانت المجموعة في <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]<nowiki/>اختيارية ولم يكن هناك أي تطابق، فإن العنصر المقابل في [[Kotlin/List|اللائحة]] <code>groupValues</code> هو [[Kotlin/List|اللائحة]] الفارغة. | إن كانت المجموعة في <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]]<nowiki/>اختيارية ولم يكن هناك أي تطابق، فإن العنصر المقابل في [[Kotlin/List|اللائحة]] <code>groupValues</code> سيكون هو [[Kotlin/List|اللائحة]] الفارغة. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="kotlin"> | <syntaxhighlight lang="kotlin"> | ||
| سطر 9: | سطر 9: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==القيمة المُعادة== | ==القيمة المُعادة== | ||
[[Kotlin/List|لائحة]] تضم مجموعة المُطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] | [[Kotlin/List|لائحة]] تضم مجموعة المُطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]. | ||
==أمثلة== | ==أمثلة== | ||
===استخدام الخاصية <code>groupValues</code>=== | ===استخدام الخاصية <code>groupValues</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>groupValues</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]+") | ||
مراجعة 21:55، 6 يوليو 2018
تعيد الخاصية groupValues لائحة تضم مجموعة المُطابقات للتعبير النمطي. حجم تلك اللائحة يساوي groupCount + 1، حيثgroupCount هو عدد المجموعات المطابَقة في التعبير النمطي. تلك المجموعات مُفهرسة من 1 حتى groupCount، والمجموعة ذات الفهرس 0 توافق المطابقة الكلية.
إن كانت المجموعة في التعبير النمطياختيارية ولم يكن هناك أي تطابق، فإن العنصر المقابل في اللائحة groupValues سيكون هو اللائحة الفارغة.
البنية العامة
abstract val groupValues: List<String>
القيمة المُعادة
لائحة تضم مجموعة المُطابقات للتعبير النمطي.
أمثلة
استخدام الخاصية groupValues
في الشيفرة التالية ننشِئ تعبيرًا نمطيًا باسم regex باستخدام التابع Regex()، ثم نعرّف سلسلة نصية باسم str، ثم نستخرج من str مجموعات النتائج عبر استدعاء الدالةmatchEntire()، ثم نستخدم الخاصية groupValues لاستخراج مجموعات النتائج، ثم نطبع الناتج:
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)?.groupValues
print(res)
}
أنظر أيضًا
- صفحة الصنف
Destructured. - الخاصية
MatchResult.destructured: الخاصيةdestructuredتعيد نسخة من الصنفMatchResult.Destructured،والتي توفّر مركبات لتفكيك قيم المجموعة المُطابقة. المركبة الأولى تقابل قيمة المجموعة المُطابقَة الأولى، والمركبة الثانية تقابل الثانية، وهكذا دواليك.