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

من موسوعة حسوب
→ التعديل السابقالتعديل اللاحق ←
مرئينص الويكي
ط استبدال النص - 'Kotlin Methods' ب'Kotlin Function'
مراجعة وتدقيق.
سطر 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">
<syntaxhighlight lang="kotlin">
سطر 8: سطر 8:
): List<String>
): List<String>
</syntaxhighlight>
</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>) {
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>
</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]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Function]]
[[تصنيف:Kotlin Text]]
[[تصنيف:Kotlin Regex]]

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

مصادر

مجلوبة من «https://wiki.hsoub.com/index.php?title=Kotlin/kotlin.text/Regex/split&oldid=16155»