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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.split()‎</code> في لغة Kotlin}}</noinclude> تستبدل الدالة<code>split()‎</code> كل المطاب...')
 
سطر 1: سطر 1:
 
<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.split()‎</code> في لغة Kotlin}}</noinclude>
 
<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">
 
<syntaxhighlight lang="kotlin">
actual fun replace(
+
actual fun split(
 
     input: CharSequence,  
 
     input: CharSequence,  
     replacement: String
+
     limit: Int = 0
): String
+
): List<String>
 
</syntaxhighlight>
 
</syntaxhighlight>
 
==القيمة المُعادة==
 
==القيمة المُعادة==
[[Kotlin/String|سلسلة نصية]]
+
[[Kotlin/List|لائحة]] تضم  [[Kotlin/String|سلاسل نصية]].
 
==أمثلة==
 
==أمثلة==
 
===استخدام التابع <code>split()‎</code>===
 
===استخدام التابع <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>) {
 
fun main(args: Array<String>) {
 
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
 
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
 
      
 
      
println(reg.replace("ab12cd34ef", "X")) // => abXcdXef
+
println(reg.split("ab12cd34ef")) // => [ab, cd, ef]
 
}
 
}
 
</syntaxhighlight>
 
</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]]
 
[[تصنيف:Kotlin Methods]]
 
[[تصنيف:Kotlin Methods]]

مراجعة 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: تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.

مصادر