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

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

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

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

inline fun String.match(regex: String): Array<String>?

منصة التشغيل المطلوبة: JS.

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

المعاملات

`regex`

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

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

مصفوفة تحتوي على السلاسل النصية المُطابقة للتعبير النمطي regex في السلسلة النصية المعطاة.

أمثلة

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

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

    print( str.match("""-?\d+(\.\d+)?""") ) // 12,
}

انظر أيضًا

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

مصادر

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

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