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

من موسوعة حسوب
→ التعديل السابقالتعديل اللاحق ←
مرئينص الويكي
ط استبدال النص - '==القيمة المُعادة==' ب'==القيمة المعادة=='
مراجعة وتدقيق.
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.find()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.find()‎</code> في Kotlin}}</noinclude>
تعيد الدالة<code>find()‎</code> فهرس أول مطابقة [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
تبحث الدالة <code>find()‎</code> عن أول محرف متطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
سطر 7: سطر 7:
     startIndex: Int = 0
     startIndex: Int = 0
): MatchResult?
): MatchResult?
</syntaxhighlight>
</syntaxhighlight>تبحث الدالة <code>find()‎</code> عن أول محرف متطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] <code>input</code> الممررة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند المحرف ذي الفهرس <code>startIndex</code>. يجب ألا تقل قيمة المعامل <code>startIndex</code> عن القيمة 0 وألا تزيد عن القيمة [[Kotlin/CharSequence/length|<code>input.length()‎</code>]].
 
==القيمة المعادة==
==القيمة المعادة==
عدد صحيح.
يعاد أول محرف تطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] المعطى من [[Kotlin/CharSequence|سلسلة المحارف]] <code>input</code>. يجدر بالذكر أن عملية البحث عن المحرف المتطابق تبدأ من المحرف ذي الفهرس <code>startIndex</code>.
==أمثلة==
==أمثلة==
===استخدام التابع <code>find()‎</code>===
استعمال الدالة <code>find()‎</code> لجلب أول رقم تطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] ‎-?\d+(\.\d+)?‎:<syntaxhighlight lang="kotlin">
ينشِئ التابع <code>Regex()‎</code> في الشيفرة الآتية تعبيرًا نمطيًا باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>find()‎</code> ويحيل القيمة المعادة إلى المتغير <code>matchResult</code>، ثم يطبع قيمة الفهرس:<syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
fun main(args: Array<String>) {
val reg = """-?\d+(\.\d+)?""".toRegex()
    val reg = """-?\d+(\.\d+)?""".toRegex()
 
    val matchResult = reg.find("aff4rb")


val matchResult = reg.find("aff4rb")
     print(matchResult?.value) // 4
      
print(matchResult?.value) // 4
}
}
</syntaxhighlight>
</syntaxhighlight>
==أنظر أيضًا==
==انظر أيضًا==
* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.


سطر 27: سطر 27:


==مصادر==
==مصادر==
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/find.html الدالة  Regex.find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/find.html صفحة الدالة Regex.find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin Regex]]

مراجعة 09:02، 30 أغسطس 2018

تبحث الدالة find()‎ عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.

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

actual fun find(
    input: CharSequence, 
    startIndex: Int = 0
): MatchResult?

تبحث الدالة find()‎ عن أول محرف متطابق مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف input الممررة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند المحرف ذي الفهرس startIndex. يجب ألا تقل قيمة المعامل startIndex عن القيمة 0 وألا تزيد عن القيمة input.length()‎.

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

يعاد أول محرف تطابق مع التعبير النمطي المعطى من سلسلة المحارف input. يجدر بالذكر أن عملية البحث عن المحرف المتطابق تبدأ من المحرف ذي الفهرس startIndex.

أمثلة

استعمال الدالة find()‎ لجلب أول رقم تطابق مع التعبير النمطي ‎-?\d+(\.\d+)?‎:

fun main(args: Array<String>) {
    val reg = """-?\d+(\.\d+)?""".toRegex()

    val matchResult = reg.find("aff4rb")

    print(matchResult?.value) // 4
}

انظر أيضًا

  • الخاصية pattern: تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
  • الخاصية options: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر

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