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

مراجعة 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: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر

الدالة Regex.containsMatchIn()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

@@ سطر 1: / سطر 1: @@
 <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">
-fun toShort(): Short
+actual fun containsMatchIn(input: CharSequence): Boolean
 </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>
 ==أنظر أيضًا==
-* <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 Methods]]