الفرق بين المراجعتين لصفحة: «Kotlin/kotlin.text/MatchResult/next»

مراجعة 23:51، 6 يوليو 2018

تعيد الدالة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 توافق المطابقة الكلية.

مصادر

الدالة MatchResult.next()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>MatchResult.next()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<code>next()‎</code> فهرس أول مطابقة [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
+تعيد الدالة<code>next()‎</code> كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]]</code> يحتوي نتائج المطابقة الموالية [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]، بداية من فهرس آخر مطابقة.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-actual fun find(
+abstract fun next(): MatchResult?
-    input: CharSequence,
-    startIndex: Int = 0
-): MatchResult?
 </syntaxhighlight>
 ==القيمة المُعادة==
-عدد صحيح.
+كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]].</code>
 ==أمثلة==
 ===استخدام التابع <code>next()‎</code>===
-ينشِئ التابع <code>Regex()‎</code> في الشيفرة الآتية تعبيرًا نمطيًا باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>next()‎</code> ويحيل القيمة المعادة إلى المتغير <code>matchResult</code>، ثم يطبع قيمة الفهرس:<syntaxhighlight lang="kotlin">
+ينشِئ التابع <code>Regex()‎</code> في الشيفرة الآتية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>find()‎</code> للحصول على مطابقات [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] <code>reg</code> في السلسلة النصية المُمرّرة، ويحيل القيمة المعادة (<code>43</code>) إلى المتغير <code>matchResult</code>، ثم يستدعي الدالة <code>next()‎</code> عبر <code>matchResult</code> للحصول على المطابقة الموالية (<code>24</code>)، ثم يطبع النتائج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-  val reg = """-?\d+(\.\d+)?""".toRegex()
+  val reg = Regex("""-?\d+(\.\d+)?""")
+ val  matchResult   = reg.find("xab43cd24y")
+ val  nextMatchResult = matchResult?.next()
-  val matchResult = reg.find("aff4rb")
+  print(matchResult?.value) // 43
+  print(nextMatchResult?.value) // 24
-  print(matchResult?.value) // 4
 }
 </syntaxhighlight>
 ==أنظر أيضًا==
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+* لخاصية <code>[[Kotlin/kotlin.text/MatchResult/destructured|MatchResult.destructured‎]]</code>: تعيد نسخة من الصنف <code>MatchResult.Destructured،</code> والتي توفّر مركبات لتفكيك قيم المجموعة المُطابقة. المركبة الأولى تقابل قيمة المجموعة المُطابقَة الأولى، والمركبة الثانية تقابل الثانية، وهكذا دواليك.
+* الخاصية <code>[[Kotlin/kotlin.text/MatchResult/groupValues|MatchResult.groupValues]]</code>: تعيد لائحة تضم مجموعة المُطابقات  للتعبير النمطي. حجم تلك اللائحة يساوي <code>groupCount + 1،</code>حيث<code>groupCount</code> هو عدد المجموعات المطابَقة في  التعبير النمطي. تلك المجموعات مُفهرسة من 1 حتى <code>groupCount،</code> والمجموعة ذات الفهرس<code>0</code> توافق المطابقة الكلية.
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</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/-regex/find.html الدالة  MatchResult.next()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-match-result/next.html الدالة  MatchResult.next()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Methods]]