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

مراجعة 14:13، 10 يوليو 2018

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

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

fun String.matches(regex: String): Boolean 

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

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

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

قيمة منطقية.

أمثلة

استخدام الدالة `matches()‎` مع السلاسل النصية

تُعرّف الشيفرة الآتية سلسلتين نصيتين باسم str و str2، ثم تستدعي الدالة 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()‎: تعيد مصفوفة مكونة من السلاسل النصية المُطابقة للتعبير النمطي المُمرّر regex في السلسلة النصية التي استٌدعيت عبرها.
mapIndexed()‎: تعيد لائحة مكونة من نتائج تطبيق الدالة transform المُمرّرة على عناصر سلسلة الحروف التي استٌدعيت عبرها وعلى فهارسها.

مصادر

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE: التابع text.matches()‎ في لغة Kotlin}}</noinclude>
-تعيد الدالة <code>matches()</code>‎ [[Kotlin/Array|مصفوفة]] مكونة من [[Kotlin/String|السلاسل النصية]] المُطابقة للتعبير النمطي المُمرّر <code>regex</code> في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.
+تعيد الدالة <code>matches()</code>‎ القيمة <code>true</code> إن طابقت [[Kotlin/String|السلسلة النصية]] أو [[Kotlin/CharSequence/index|سلسلة الحروف]] التي استٌدعيت عبرها  التعبير النمطي المُمرّر <code>regex</code>.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-inline fun String.match(regex: String): Array<String>?
+fun String.matches(regex: String): Boolean
+inline infix fun CharSequence.matches(regex: Regex): Boolean
 </syntaxhighlight>يُلاحَظ وجود الكلمة المفتاحية <code>inline</code> للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع <nowiki/>[[Kotlin/inline functions|توثيق الدوال المباشرة (inline functions)]].
 ==القيم المعادة==
-[[Kotlin/Array|مصفوفة]] مكونة من [[Kotlin/String|سلاسل نصية]].
+قيمة منطقية.
 ==أمثلة==
 ===استخدام الدالة <code>matches()‎</code> مع السلاسل النصية===
-تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلة نصية]] باسم <code>str</code>، ثم تستدعي الدالة <code>matches()‎</code> عبرها وتمرر  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
+تُعرّف الشيفرة الآتية [[Kotlin/String|سلسلتين نصيتين]] باسم <code>str</code> و <code>str2</code>، ثم تستدعي الدالة <code>matches()‎</code> عبرهما وتمرر  [[Kotlin/String|سلسلة نصية]] كوسيط، ثم تطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
 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/Array|مصفوفة]] مكونة من [[Kotlin/String|السلاسل النصية]] المُطابقة للتعبير النمطي المُمرّر <code>regex</code> في [[Kotlin/String|السلسلة النصية]] التي استٌدعيت عبرها.
 *<code>[[Kotlin/kotlin.text/mapIndexed|mapIndexed()]]‎</code>: تعيد  [[Kotlin/String|لائحة]] مكونة من نتائج تطبيق الدالة <code>transform</code> المُمرّرة  على عناصر [[Kotlin/CharSequence/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 صفحة الدالة text.matches()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Method]]