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

من موسوعة حسوب
مرئينص الويكي
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.containsMatchIn()‎</code> في لغة Kotlin}}</noinclude> تحول الدالة<code>containsMatchIn()‎</code>...'
 
ط إضافة قسم "المعاملات"
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.containsMatchIn()‎</code> في لغة Kotlin}}</noinclude>
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.containsMatchIn()‎</code> في Kotlin}}</noinclude>
تحول الدالة<code>containsMatchIn()‎</code> قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>[[Kotlin/Short /index|Short]]</code>، والذي قد يعني أنه سيحسب بشكل تقريبي.
تتحقق الدالة <code>containsMatchIn()‎</code> إن كان بإمكان [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من [[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
==البنية العامة==
==البنية العامة==
<syntaxhighlight lang="kotlin">
<syntaxhighlight lang="kotlin">
fun toShort(): Short
actual fun containsMatchIn(input: CharSequence): Boolean
 
</syntaxhighlight>
</syntaxhighlight>
==القيمة المُعادة==
==المعاملات==
عدد من النوع<code>[[Kotlin/Short /index|Short]]</code>.
 
=== <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>x</code>، ثم تستخدم الدالة<code>()containsMatchIn</code> على <code>x</code>، ثم تطبع الناتج:<nowiki/><syntaxhighlight lang="kotlin">
fun main(args: Array<String>) {
    fun main(args: Array<String>) {  
    // يطابق التعبير النمطي التالي الأعداد
        val x : Float = 52.7f
    val reg = Regex("""-?\d+(\.\d+)?""")
 
    val str1 = "abc123def"
    val str2 = "abcdefg!@#"
 
    print(reg.containsMatchIn(str1)) // true
    print(reg.containsMatchIn(str2)) // false


        println(x.toShort() )// 52
}
    }
</syntaxhighlight>
</syntaxhighlight>
==أنظر أيضًا==
==انظر أيضًا==
* <code>[[Kotlin/Float/toByte|toByte()]]</code>‎ : تحوّل قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>Byte</code>.
* الدالة <code>[[Kotlin/kotlin.text/Regex/find|find()‎]]</code>: تبحث عن أول محرف متطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
* <code>[[Kotlin/Float/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
* الدالة <code>[[Kotlin/kotlin.text/Regex/matches|matches()‎]]</code>: تتحقق من مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها. 
* <code>[[Kotlin/Float/div|div()]]</code>‎ : تقوم  بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
* الدالة <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire()‎]]</code>: تحاول مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها.
* <code>[[Kotlin/Float/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
* الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.


==مصادر==
==مصادر==
* [https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-float/to-short.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»