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