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

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: الدالة <code>Regex.split()‎</code> في لغة Kotlin}}</noinclude> تستبدل الدالة<code>split()‎</code> كل المطاب...')
 
ط
 
(4 مراجعات متوسطة بواسطة 3 مستخدمين غير معروضة)
سطر 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/kotlin.text/Regex|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممررة إليها.
 
==البنية العامة==
 
==البنية العامة==
 
<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|سلسلة نصية]]
+
== المعاملات ==
 +
 
 +
=== <code>input</code> ===
 +
[[Kotlin/CharSequence|سلسلة المحارف]] المراد اقتطاع الأجزاء المجاورة لتلك المتطابقة مع تعبير نمطي وجلبها.
 +
 
 +
=== <code>limit</code> ===
 +
عدد صحيح موجب يحدد الحد الأقصى لعدد الأجزاء المقتطعة المراد جلبها. قيمته الافتراضية هي: 0 أي لا يوجد حد أقصى.
 +
 
 +
==القيمة المعادة==
 +
تعاد [[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/String|السلسلة النصية]] المُمررّة  [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] <code>reg</code> (أي للتعابير العددية)، ثم يطبع الناتج:<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.replace("ab12cd34ef", "X")) // => abXcdXef
+
 
 +
     println(reg.split("ab12cd34ef")) // => [ab, cd, ef]
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
==أنظر أيضًا==
+
==انظر أيضًا==
* الخاصية <code>[[Kotlin/kotlin.text/Regex/pattern|pattern]]:</code> تعيد السلسلة النصية النمطية (pattern string) التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+
* الدالة <code>[[Kotlin/kotlin.text/Regex/replace|replace()‎]]</code>: تبدل سلسلة النصية معينة مكان كل تطابقات <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها في <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليها أو <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] التي تعيدها الدالة الممررة إليها.
* <code>[[Kotlin/kotlin.text/Regex/findAll| findAll()‎]]:</code> تعيد كل المطابقات [[Kotlin/kotlin.text/Regex/index|للتعبير النمطي]] الذي استُدعيت عبره  في الوسيط المُمرّر <code>input،</code>بداية من الفهرس المحدد بالوسيط <code>startIndex.</code>
+
* الدالة <code>[[Kotlin/kotlin.text/Regex/find|find()‎]]</code>: تبحث عن أول محرف متطابق مع [[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها في [[Kotlin/CharSequence|سلسلة المحارف]] الممرَّرة إليها. يمكن البحث في [[Kotlin/CharSequence|سلسلة المحارف]] المعطاة بأكملها، أو يمكن بدء عملية البحث عند محرف معين.
 
+
* الدالة <code>[[Kotlin/kotlin.text/Regex/matchEntire|matchEntire()‎]]</code>: تحاول مطابقة جميع محارف <nowiki/>[[Kotlin/CharSequence|السلسلة]] الممررة إليها مع <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استدعي معها.
* الخاصية <code>[[Kotlin/kotlin.text/Regex/options|options]]:</code> تعبر عن مجموعة الخيارات التي استُخدمت في إنشاء التعبير النمطي الذي استُدعيت عبره.
+
* الدالة <code>[[Kotlin/kotlin.text/Regex/containsMatchIn|containsMatchIn()‎]]</code>: تتحقق إن كان بإمكان <nowiki/>[[Kotlin/kotlin.text/Regex/index|التعبير النمطي]] الذي استُدعي معها مطابقة محرفٍ واحدٍ على الأقل من <nowiki/>[[Kotlin/CharSequence|سلسلة المحارف]] المُمرّرة إليه.
 
 
 
==مصادر==
 
==مصادر==
* [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 Function]]
 +
[[تصنيف:Kotlin Text]]
 +
[[تصنيف:Kotlin Regex]]

المراجعة الحالية بتاريخ 14: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]
}

انظر أيضًا

مصادر