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

مراجعة 18:50، 5 يوليو 2018

تعيد الدالةsplit()‎ لائحة تضم السلاسل النصية الموجودة بين مطابقات التعبير النمطي الذي استُدعيت عبره في الكائن المُمرّر input، الحد الأقصى لعدد السلاسل النصية يحدده الوسيط limit، وقيمته الابتدائية تساوي 0، وتعني لا يوجد عدد أقصى.

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

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

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

لائحة تضم سلاسل نصية.

أمثلة

استخدام التابع `split()‎`

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

fun main(args: Array<String>) {
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
    
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>
-تستبدل الدالة<code>split()‎</code> كل المطابقات  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، [[Kotlin/String|بالسلسلة النصية]] المُمرّرة <code>replacement</code>.
+تعيد الدالة<code>split()‎</code>  [[Kotlin/List|لائحة]] تضم  [[Kotlin/String|السلاسل النصية]] الموجودة بين مطابقات  [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعيت عبره في الكائن المُمرّر <code>input</code>، الحد الأقصى لعدد [[Kotlin/String|السلاسل النصية]] يحدده الوسيط <code>limit</code>، وقيمته الابتدائية تساوي <code>0</code>، وتعني لا يوجد عدد أقصى.
 ==البنية العامة==
 <syntaxhighlight lang="kotlin">
-actual fun replace(
+actual fun split(
      input: CharSequence,
-     replacement: String
+     limit: Int = 0
-): String
+): List<String>
 </syntaxhighlight>
 ==القيمة المُعادة==
-[[Kotlin/String|سلسلة نصية]]
+[[Kotlin/List|لائحة]] تضم  [[Kotlin/String|سلاسل نصية]].
 ==أمثلة==
 ===استخدام التابع <code>split()‎</code>===
-ينشِئ التابع <code>[[Kotlin/kotlin.text/Regex/Init|Regex()]]‎</code> في الشيفرة الآتية <nowiki/>[[Kotlin/kotlin.text/Regex/index|تعبيرًا نمطيًا]] باسم <code>reg</code> لمطابقة التعابير العددية، ثم يستدعي عبره الدالة <code>split()‎</code> لاستبدال المطابقات الموجودة في [[Kotlin/String|السلسلة النصية]] المُمررّة  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] <code>reg</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
-println(reg.replace("ab12cd34ef", "X")) // => abXcdXef
+println(reg.split("ab12cd34ef")) // => [ab, cd, ef]
 }
 </syntaxhighlight>
@@ سطر 26: / سطر 26: @@
 ==مصادر==
-* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/replace.html الدالة  Regex.split()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
+* [http://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/-regex/split.html الدالة  Regex.split()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.]
 [[تصنيف:Kotlin]]
 [[تصنيف:Kotlin Methods]]