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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.find()‎</code> في لغة Kotlin}}</noinclude> تعيد الدالة<code>find()‎</code> القيمة <code>true...')
 
ط (إضافة قسم "المعاملات")
 
(5 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
−
actual fun containsMatchIn(input: CharSequence): Boolean
+
actual fun find(
 +
    input: CharSequence,
 +
    startIndex: Int = 0
 +
): MatchResult?
 +
</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>]].
 +
==المعاملات==
  
−
</syntaxhighlight>
+
=== <code>input</code> ===
−
==القيمة المُعادة==
+
[[Kotlin/CharSequence|سلسلة المحارف]] التي يراد جلب أول محرف متطابق من محارفها مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] المعطى.
−
قيمة منطقية.
+
 
 +
=== <code>startIndex</code> ===
 +
[[Kotlin/Int|عدد صحيح]] يحدد فهرس المحرف الذي يراد بدء عملية المطابقة عنده. القيمة الافتراضية له هي: 0؛ أي بدء عملية المطابقة عند المحرف الأول.
 +
 
 +
==القيمة المعادة==
 +
يعاد أول محرف تطابق مع [[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>، ثم يطبع الناتج:<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"
 
−
      
 
−
// سلسلة نصية لا تحتوي أعدادا، وبالتالي لن يوجد تطابق مع التعبير النمطي
 
−
val str2 = "ash d"
 
−
   
 
−
print(reg.containsMatchIn(str1) ) // true
 
−
print(reg.containsMatchIn(str2) ) // false
 
  
 +
    print(matchResult?.value) // 4
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
−
==أنظر أيضًا==
+
==انظر أيضًا==
−
* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+
* الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
−
 
+
* الدالة <code>[[Kotlin/kotlin.text/Regex/findAll|findAll()‎]]</code>: تبحث عن جميع المحارف المتطابقة مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
−
* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+
* الدالة <code>[[Kotlin/kotlin.text/Regex/matches|matches()‎]]</code>: تتحقق من مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها. 
 +
* الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
  
 
==مصادر==
 
==مصادر==
−
* [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 Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin Regex]]

المراجعة الحالية بتاريخ 05:57، 1 سبتمبر 2018

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

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

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

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

المعاملات

input

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

startIndex

عدد صحيح يحدد فهرس المحرف الذي يراد بدء عملية المطابقة عنده. القيمة الافتراضية له هي: 0؛ أي بدء عملية المطابقة عند المحرف الأول.

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

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

أمثلة

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

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

    val matchResult = reg.find("aff4rb")

    print(matchResult?.value) // 4
}

انظر أيضًا

مصادر

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