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

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

مراجعة 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: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر

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