الفرق بين المراجعتين ل"Kotlin/kotlin.text/MatchResult/next"

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>MatchResult.next()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>next()‎</code> فهرس أول...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>MatchResult.next()‎</code> في لغة Kotlin}}</noinclude>
 
<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">
 
<syntaxhighlight lang="kotlin">
−
actual fun find(
+
abstract fun next(): MatchResult?  
−
    input: CharSequence,
+
 
−
    startIndex: Int = 0
 
−
): MatchResult?
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==القيمة المُعادة==
 
==القيمة المُعادة==
−
عدد صحيح.
+
كائنًا من النوع <code>[[Kotlin/kotlin.text/MatchResult/index|MatchResult]].</code>
 
==أمثلة==
 
==أمثلة==
 
===استخدام التابع <code>next()‎</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>) {
 
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>
 
</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]]
 
[[تصنيف:Kotlin Methods]]
 
[[تصنيف:Kotlin Methods]]

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

مصادر

مجلوبة من "https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/MatchResult/next&oldid=12321"