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

المراجعة الحالية بتاريخ 10:55، 4 سبتمبر 2018

تتحقق الدالة matches()‎ من مطابقة التعبير النمطي المُمرّر إليها السلسلة النصية أو سلسلة المحارف التي استٌدعيت معها.

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

fun String.matches(regex: String): Boolean 

inline infix fun CharSequence.matches(regex: Regex): Boolean

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)).

المعاملات

`regex`

التعبير النمطي المراد التحقق من مطابقته مع السلسلة النصية المعطاة.

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

تعاد القيمة true إن طابق التعبير النمطي regex السلسلة النصية أو سلسلة المحارف التي استٌدعيت معها، أو تعاد القيمة false خلاف ذلك.

أمثلة

مثالٌ على استعمال الدالة matches()‎:

fun main(args: Array<String>) {
    val str = "sds12ff"
    val str2 = "sdsff"

    print(str.matches ("""-?\d+(\.\d+)?""")) // true
    print(str2.matches ("""-?\d+(\.\d+)?""")) // false
}

انظر أيضًا

الدالة match()‎: تطابق التعبير النمطي المُمرّر إليها في السلسلة النصية التي استٌدعيت معها.
الدالة matches()‎: تتحقق من مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.
الدالة findAll()‎: تبحث عن جميع المحارف المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممرَّرة إليها. يمكن البحث في سلسلة المحارف المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
الدالة matchEntire()‎: تحاول مطابقة جميع محارف السلسلة الممررة إليها مع التعبير النمطي الذي استدعي معها.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع text.matches()‎ في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>matches()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة <code>matches()</code>‎ [[Kotlin/Array|مصفوفة]] مكونة من [[Kotlin/String|السلاسل النصية]] المُطابقة للتعبير النمطي المُمرّر <code>regex</code> في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.
+تتحقق الدالة <code>matches()</code>‎ من مطابقة التعبير النمطي المُمرّر إليها [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.match(regex: String): Array<String>?
+fun String.matches(regex: String): Boolean
-</syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
+inline infix fun CharSequence.matches(regex: Regex): Boolean
+</syntaxhighlight>وجود الكلمة المفتاحية <code>inline</code> يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة [[Kotlin/inline functions|الدوال المباشرة (inline functions)]]).
+== المعاملات ==
+=== <code>regex</code> ===
+[[Kotlin/kotlin.text/Regex|التعبير النمطي]] المراد التحقق من مطابقته مع السلسلة النصية المعطاة.
 ==القيم المعادة==
-[[Kotlin/Array|مصفوفة]] مكونة من [[Kotlin/String|سلاسل نصية]].
+تعاد القيمة <code>true</code> إن طابق التعبير النمطي <code>regex</code> [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence|سلسلة المحارف]] التي استٌدعيت معها، أو تعاد القيمة <code>false</code> خلاف ذلك.
 ==أمثلة==
-===استخدام الدالة <code>matches()‎</code> مع السلاسل النصية===
+مثالٌ على استعمال الدالة <code>matches()‎</code>:<syntaxhighlight lang="kotlin">
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>matches()‎</code> عبرها وتمرر  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val str = "sds12ff"
+    val str = "sds12ff"
+     val str2 = "sdsff"
-print( str.match("""-?\d+(\.\d+)?""") ) // 12,
+    print(str.matches ("""-?\d+(\.\d+)?""")) // true
+    print(str2.matches ("""-?\d+(\.\d+)?""")) // false
 }
 </syntaxhighlight>
 ==انظر أيضًا==
-*<code>[[Kotlin/kotlin.text/mapTo|mapTo()]]‎</code>: تضيف  إلى المجموعة المتغيرة المُمرّرة <code>destination</code> نتائج تطبيق الدالة <code>transform</code> على عناصر سلسلة الحروف التي استٌدعيت عبرها.
+*الدالة <code>[[Kotlin/kotlin.text/match|match()]]‎</code>: تطابق التعبير النمطي المُمرّر إليها في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت معها.
-*<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]‎</code>: تعيد  [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها وعلى فهارسها.
+*الدالة <code>[[Kotlin/kotlin.text/Regex/matches|matches()‎]]</code>: تتحقق من مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها.
+* الدالة <code>[[Kotlin/kotlin.text/Regex/findAll|findAll()‎]]</code>: تبحث عن جميع المحارف المتطابقة مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
+* الدالة <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire()‎]]</code>: تحاول مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها.
 ==مصادر==
-*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/match.html صفحة الدالة text.matches()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/matches.html صفحة الدالة matches()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
-[[تصنيف:Kotlin Method]]
+[[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]