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

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


// سلسلة نصية تحتوي أعدادا، وبالتالي سيوجد تطابق مع التعبير النمطي
    val str1 = "abc123def"
val str1 = "as12d"
     val str2 = "abcdefg!@#"
      
 
// سلسلة نصية لا تحتوي أعدادا، وبالتالي لن يوجد تطابق مع التعبير النمطي
     print(reg.containsMatchIn(str1)) // true
val str2 = "ash d"
    print(reg.containsMatchIn(str2)) // false
      
print(reg.containsMatchIn(str1) ) // true
print(reg.containsMatchIn(str2) ) // false


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


سطر 31: سطر 28:


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

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

تتحقق الدالة containsMatchIn()‎ إن كان بإمكان التعبير النمطي الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف المُمرّرة إليه.

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

actual fun containsMatchIn(input: CharSequence): Boolean

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

تعاد القيمة true المنطقية إن بإمكان التعبير النمطي المعطى مطابقة محرفٍ واحدٍ على الأقل من سلسلة المحارف input، أو تعاد القيمة false خلاف ذلك.

أمثلة

تنشئ الدالة Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة الأعداد، ثم تُستعمَل الدالة containsMatchIn()‎ مع ذلك التعبير النمطي لمعرفة إن كانت تحتوي مجموعةٌ من المحارف على أرقام أو أعداد:

fun main(args: Array<String>) {
    // يطابق التعبير النمطي التالي الأعداد
    val reg = Regex("""-?\d+(\.\d+)?""")

    val str1 = "abc123def"
    val str2 = "abcdefg!@#"

    print(reg.containsMatchIn(str1)) // true
    print(reg.containsMatchIn(str2)) // false

}

انظر أيضًا

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

مصادر

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