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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>MatchResult.next()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>next()‎</code> فهرس أول...'
 
مراجعة وتدقيق.
 
(3 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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> يحوي نتائج المطابقة التالية [[Kotlin/kotlin.text/Regex/index|لتعبير نمطي]] محدد التي تبدأ من الفهرس الذي انتهت عنده آخر عملية مطابقة.
==أمثلة==
==أمثلة==
===استخدام التابع <code>next()‎</code>===
ينشِئ التابع <code>Regex()‎</code> في الشيفرة التالية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي معه الدالة <code>find()‎</code> للحصول على مطابقات [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] <code>reg</code> في السلسلة النصية المُمرّرة، وإحالة القيمة المعادة (هي 43 في مثالنا هذا) إلى المتغير <code>matchResult</code>. تستعمل بعد ذلك الدالة <code>next()‎</code> مع المتغير <code>matchResult</code> للحصول على المطابقة التالية:<syntaxhighlight lang="kotlin">
ينشِئ التابع <code>Regex()‎</code> في الشيفرة الآتية تعبيرًا نمطيًا باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>next()‎</code> ويحيل القيمة المعادة إلى المتغير <code>matchResult</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/groupValues|MatchResult.groupValues]]</code>: تمثل قائمة بقيم المجموعة المفهرسة المتطابقة.
 
* الخاصية <code>[[Kotlin/kotlin.text/MatchResult/groups|MatchResult.groups]]</code>: تمثل <nowiki/>[[Kotlin/collections|مجموعةً]] (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] محدد.
* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
* الخاصية <code>[[Kotlin/kotlin.text/MatchResult/range|MatchResult.range]]</code>: تمثل مجال الفهارس الذي يحدد مكان مُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبير نمطي]] محدد في السلسلة النصية الأصلية.
* الخاصية <code>[[Kotlin/kotlin.text/MatchResult/value|MatchResult.value]]</code>: تمثل السلسلة النصية المُدخلة، أو جزءًا منها، والمُطابقة <nowiki/>[[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]]. 


==مصادر==
==مصادر==
* [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 Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin MatchResult]]

المراجعة الحالية بتاريخ 07:11، 30 أغسطس 2018

تعيد الدالة next()‎ كائنًا من النوع MatchResult يحوي ناتج المطابقة التالية لتعبير نمطي محدد والذي يبدأ عند الفهرس الذي انتهت عنده آخر عملية مطابقة (أي يبدأ عن المحرف الذي يلي آخر محرف تمت مطابقته).

البنية العامة

abstract fun next(): MatchResult?

القيمة المعادة

يعاد كائنٌ من النوع MatchResult يحوي نتائج المطابقة التالية لتعبير نمطي محدد التي تبدأ من الفهرس الذي انتهت عنده آخر عملية مطابقة.

أمثلة

ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي معه الدالة find()‎ للحصول على مطابقات التعبير النمطي reg في السلسلة النصية المُمرّرة، وإحالة القيمة المعادة (هي 43 في مثالنا هذا) إلى المتغير matchResult. تستعمل بعد ذلك الدالة next()‎ مع المتغير matchResult للحصول على المطابقة التالية:

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
}

انظر أيضًا

مصادر

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