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

مراجعة 12:59، 30 أغسطس 2018

تقتطع الدالة split()‎ المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي الذي استُدعي معها في سلسلة المحارف الممررة إليها.

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

actual fun split(
    input: CharSequence, 
    limit: Int = 0
): List<String>

المعاملات

`input`

سلسلة المحارف المراد اقتطاع الأجزاء المجاورة لتلك المتطابقة مع تعبير نمطي وجلبها.

`limit`

عدد صحيح موجب يحدد الحد الأقصى لعدد الأجزاء المقتطعة المراد جلبها. قيمته الافتراضية هي: 0 أي لا يوجد حد أقصى.

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

تعاد قائمة تضم المحارف الموجودة بين الأجزاء المتطابقة مع التعبير النمطي المعطى في سلسلة المحارف input.

أمثلة

ينشِئ التابع Regex()‎ في الشيفرة التالية تعبيرًا نمطيًا باسم reg لمطابقة القيم العددية، ثم يستدعي معه الدالة split()‎ لجلب جميع الأحرف المجاورة لأعداد:

fun main(args: Array<String>) {
    // يطابق التعبير النمطي التالي جميع الأعداد
    val reg = Regex("""-?\d+(\.\d+)?""")

    println(reg.split("ab12cd34ef")) // => [ab, cd, ef]
}

انظر أيضًا

الخاصية pattern: تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
findAll()‎: تعيد كل المطابقات للتعبير النمطي الذي استُدعيت عبره في الوسيط المُمرّر input،بداية من الفهرس المحدد بالوسيط startIndex.

الخاصية options: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.split()‎</code> في لغة Kotlin}}</noinclude>
+<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.split()‎</code> في Kotlin}}</noinclude>
-تعيد الدالة<code>split()‎</code>  [[Kotlin/List|لائحة]] تضم  [[Kotlin/String|السلاسل النصية]] الموجودة بين مطابقات  [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، الحد الأقصى لعدد [[Kotlin/String|السلاسل النصية]] يحدده الوسيط <code>limit</code>، وقيمته الابتدائية تساوي <code>0</code>، وتعني لا يوجد عدد أقصى.
+تقتطع الدالة <code>split()‎</code> المحارف الموجودة بين الأجزاء المتطابقة مع [[Kotlin/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
@@ سطر 8: / سطر 8: @@
 ): List<String>
 </syntaxhighlight>
+== المعاملات ==
+=== <code>input</code> ===
+[[Kotlin/CharSequence|سلسلة المحارف]] المراد اقتطاع الأجزاء المجاورة لتلك المتطابقة مع تعبير نمطي وجلبها.
+=== <code>limit</code> ===
+عدد صحيح موجب يحدد الحد الأقصى لعدد الأجزاء المقتطعة المراد جلبها. قيمته الافتراضية هي: 0 أي لا يوجد حد أقصى.
 ==القيمة المعادة==
-[[Kotlin/List|لائحة]] تضم  [[Kotlin/String|سلاسل نصية]].
+تعاد [[Kotlin/collection/List|قائمة]] تضم المحارف الموجودة بين الأجزاء المتطابقة مع [[Kotlin/kotlin.text/Regex|التعبير النمطي]] المعطى في سلسلة المحارف <code>input</code>.
 ==أمثلة==
-===استخدام التابع <code>split()‎</code>===
+ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة التالية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة القيم العددية، ثم يستدعي معه الدالة <code>split()‎</code> لجلب جميع الأحرف المجاورة لأعداد:<syntaxhighlight lang="kotlin">
-ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة الآتية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>split()‎</code> للحصول على  [[Kotlin/List|لائحة]] تضم  [[Kotlin/String|السلاسل النصية]] الموجودة بين مطابقات [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] <code>reg</code> الموجودة في [[Kotlin/String|السلسلة النصية]] المُمررّة  (أي للتعابير العددية)، ثم يطبع الناتج:<syntaxhighlight lang="kotlin">
 fun main(args: Array<String>) {
-val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
+    // يطابق التعبير النمطي التالي جميع الأعداد
+    val reg = Regex("""-?\d+(\.\d+)?""")
-println(reg.split("ab12cd34ef")) // => [ab, cd, ef]
+     println(reg.split("ab12cd34ef")) // => [ab, cd, ef]
 }
 </syntaxhighlight>
-==أنظر أيضًا==
+==انظر أيضًا==
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+*الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
-* <code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
+*<code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
-* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+*الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
 ==مصادر==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/split.html الدالة  Regex.split()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+*[http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/split.html صفحة الدالة Regex.split()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Function]]
+[[تصنيف:Kotlin Text]]
+[[تصنيف:Kotlin Regex]]