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