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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.containsMatchIn()‎</code> في لغة Kotlin}}</noinclude> تحول الدالة<code>containsMatchIn()‎</code>...')
 
سطر 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> القيمة <code>true</code> إن وَجَد [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره على الأقل تطابقا واحدًا في الوسيط المُمرّر.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="kotlin">
 
<syntaxhighlight lang="kotlin">
fun toShort(): Short
+
actual fun containsMatchIn(input: CharSequence): Boolean
 +
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==القيمة المُعادة==
 
==القيمة المُعادة==
عدد من النوع<code>[[Kotlin/Short /index|Short]]</code>.
+
قيمة منطقية.
 
==أمثلة==
 
==أمثلة==
===استخدام الدالة <code>()containsMatchIn</code>===
+
===استخدام التابع <code>containsMatchIn()</code>===
تعرّف الشيفرة الآتية عددًا باسم <code>x</code>، ثم تستخدم الدالة<code>()containsMatchIn</code> على <code>x</code>، ثم تطبع الناتج:<nowiki/><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 x : Float = 52.7f
+
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
  
        println(x.toShort() )// 52
+
// سلسلة نصية تحتوي أعدادا، وبالتالي سيوجد تطابق مع التعبير النمطي
    }
+
val str1 = "as12d"
 +
   
 +
// سلسلة نصية لا تحتوي أعدادا، وبالتالي لن يوجد تطابق مع التعبير النمطي
 +
val str2 = "ash d"
 +
   
 +
print(reg.containsMatchIn(str1) ) // true
 +
print(reg.containsMatchIn(str2) ) // false
 +
 
 +
}
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==أنظر أيضًا==
 
==أنظر أيضًا==
* <code>[[Kotlin/Float/toByte|toByte()]]</code>‎ : تحوّل قيمة العنصر الذي استُدعيت عبره إلى عدد من النوع <code>Byte</code>.
+
* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
* <code>[[Kotlin/Float/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
+
 
* <code>[[Kotlin/Float/div|div()]]</code>‎ : تقوم  بقسمة العدد الذي استُدعيت عبره على العدد الممرّر.
+
* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
* <code>[[Kotlin/Float/inc|inc()]]</code>‎ : ترفع قيمة العدد الذي استُدعيت عبره بواحد ثم تعيد القيمة الناتجة.
 
  
 
==مصادر==
 
==مصادر==
* [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 Methods]]

مراجعة 19:27، 4 يوليو 2018

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

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

actual fun containsMatchIn(input: CharSequence): Boolean

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

قيمة منطقية.

أمثلة

استخدام التابع containsMatchIn()‎

ينشِئ التابع Regex()‎ في الشيفرة الآتية تعبيرًا نمطيًا باسم reg لمطابقة التعابير العددية، ثم يستدعي عبره الدالة containsMatchIn()‎، ثم يطبع الناتج:

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

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

}

أنظر أيضًا

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

مصادر