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

مراجعة 20:06، 4 يوليو 2018

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

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

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

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

عدد صحيح.

أمثلة

استخدام التابع `find()‎`

ينشِئ التابع Regex()‎ في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة find()‎ ويحيل القيمة المعادة إلى المتغير matchResult، ثم يطبع قيمة الفهرس:

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

 val matchResult = reg.find("aff4rb")
    
 print(matchResult?.value) // 4
}

أنظر أيضًا

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

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

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: الدالة <code>Regex.find()‎</code> في لغة Kotlin}}</noinclude>
-تعيد الدالة<code>find()‎</code> القيمة <code>true</code> إن وَجَد [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره على الأقل تطابقا واحدًا في الوسيط المُمرّر.
+تعيد الدالة<code>find()‎</code> فهرس أول مطابقة [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-actual fun containsMatchIn(input: CharSequence): Boolean
+actual fun find(
+    input: CharSequence,
+    startIndex: Int = 0
+): MatchResult?
 </syntaxhighlight>
 ==القيمة المُعادة==
-قيمة منطقية.
+عدد صحيح.
 ==أمثلة==
 ===استخدام التابع <code>find()‎</code>===
-ينشِئ التابع <code>Regex()‎</code> في الشيفرة الآتية تعبيرًا نمطيًا باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>find()‎</code>، ثم يطبع الناتج:<syntaxhighlight lang="kotlin">
+ينشِئ التابع <code>Regex()‎</code> في الشيفرة الآتية تعبيرًا نمطيًا باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>find()‎</code> ويحيل القيمة المعادة إلى المتغير <code>matchResult</code>، ثم يطبع قيمة الفهرس:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
+ val reg = """-?\d+(\.\d+)?""".toRegex()
-// سلسلة نصية تحتوي أعدادا، وبالتالي سيوجد تطابق مع التعبير النمطي
+ val matchResult = reg.find("aff4rb")
-val str1 = "as12d"
-// سلسلة نصية لا تحتوي أعدادا، وبالتالي لن يوجد تطابق مع التعبير النمطي
+ print(matchResult?.value) // 4
-val str2 = "ash d"
-print(reg.containsMatchIn(str1) ) // true
-print(reg.containsMatchIn(str2) ) // false
 }
 </syntaxhighlight>
@@ سطر 31: / سطر 27: @@
 ==مصادر==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/contains-match-in.html الدالة  Regex.find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/find.html الدالة  Regex.find()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Methods]]