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

من موسوعة حسوب
→ التعديل السابق
مرئينص الويكي
ط استبدال النص - '==القيمة المُعادة==' ب'==القيمة المعادة=='
ط إضافة قسم "المعاملات"
 
(2 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 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">
سطر 6: سطر 6:


</syntaxhighlight>
</syntaxhighlight>
==المعاملات==
=== <code>input</code> ===
[[Kotlin/CharSequence|سلسلة المحارف]] التي يراد التحقق من تطابق أحد محارفها -على الأقل- مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] المعطى.
==القيمة المعادة==
==القيمة المعادة==
قيمة منطقية.
تعاد القيمة <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 str2 = "abcdefg!@#"


// سلسلة نصية تحتوي أعدادا، وبالتالي سيوجد تطابق مع التعبير النمطي
     print(reg.containsMatchIn(str1)) // true
val str1 = "as12d"
    print(reg.containsMatchIn(str2)) // false
      
// سلسلة نصية لا تحتوي أعدادا، وبالتالي لن يوجد تطابق مع التعبير النمطي
val str2 = "ash d"
   
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/find|find()‎]]</code>: تبحث عن أول محرف متطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
 
* الدالة <code>[[Kotlin/kotlin.text/Regex/matches|matches()‎]]</code>: تتحقق من مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها. 
* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
* الدالة <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire()‎]]</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.containsMatchIn()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/contains-match-in.html صفحة الدالة Regex.containsMatchIn()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin]]
[[تصنيف:Kotlin Methods]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin Regex]]

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

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

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

actual fun containsMatchIn(input: CharSequence): Boolean

المعاملات

input

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

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

تعاد القيمة 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

}

انظر أيضًا

مصادر

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