الدالة text.split() في لغة Kotlin
تقتطع الدالة split() المحارف الموجودة بين الأجزاء المتطابقة مع تعبير نمطي معين أو بين سلاسل نصية أو محارف معينة في سلسلة المحارف الممررة إليها.
البنية العامة
fun CharSequence.split(
regex: Pattern,
limit: Int = 0
): List<String>
Platform and version requirements: JVM
inline fun CharSequence.split(
regex: Regex,
limit: Int = 0
): List<String>
في حال استدعاء الدالة split() عبر سلسلة حروف مع تمرير تعبير نمطي regex كوسيط فستعيد لائحة مكونة من السلاسل النصية الموجودة حول مُطابقات التعبير النمطي regex. الوسيط limit يحدد الحد الأقصى لعدد السلاسل النصية في اللائحة المُعادة.
fun CharSequence.split(
vararg delimiters: String,
ignoreCase: Boolean = false,
limit: Int = 0
): List<String>
في حال استدعاء الدالة split() عبر سلسلة حروف مع تمرير سلسلة نصية delimiters كوسيط فستعيد لائحة مكونة من السلاسل النصية الموجودة حول المُحدِّدات المُتضمّنة في delimiters. الوسيط limit يحدد الحد الأقصى لعدد السلاسل النصية في اللائحة المُعادة. والوسيط ignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الأحرف (أي لا تفرق بين الحروف الصغيرة والكبيرة).
لتجنب الالتباس عندما تحتوي السلاسل النصية الموجودة في الوسيط المُمرّر delimiters حروفا مشتركة، فإنّ الدالة findAnyOf() تبدأ من بداية تلك السلسلة النصية نحو نهايتها، وتبحث عند كل موضع عن العنصر الأول في delimitersوالذي يطابق أحد العناصر الموجودة في delimitersعند ذلك الموضع.
fun CharSequence.split(
vararg delimiters: Char,
ignoreCase: Boolean = false,
limit: Int = 0
): List<String>
في حال استدعاء الدالة split() عبر سلسلة حروف مع تمرير سلسلة الحروف delimiters فستعيد لائحة مكونة من السلاسل النصية الموجودة حول المُحدِّدات المُتضمّنة في delimiters. الوسيط limit يحدد الحد الأقصى لعدد السلاسل النصية في اللائحة المُعادة. والوسيط ignoreCase يحدد ما إذا كانت الدالة ستتجاهل حالة الأحرف (أي لا تفرق بين الحروف الصغيرة والكبيرة).
يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions).
المعاملات
regex
التعبير النمطي الذي يراد أن يطابق سلسلة المحارف المعطاة.
limit
عدد صحيح موجب يحدد الحد الأقصى لعدد الأجزاء المقتطعة المراد جلبها. قيمته الافتراضية هي: 0 أي لا يوجد حد أقصى.
delimiters
السلاسل النصية التي تمثل
ignoreCase
قيمة منطقية تحدد إن كان يراد تجاهل حالة الأحرف أثناء إجراء عملية الموازنة أم لا. القيمة الافتراضية هي: false (أي أخذ حالة الأحرف بالحسبان).
القيم المعادة
لائحة مكونة سلاسل نصية.
أمثلة
مثالٌ على استعمال الدالة ()split مع سلسلة نصية:
fun main(args: Array<String>) {
val str = "wiki.hsoub.com"
println(str.split(".")) // [wiki, hsoub, com]
}
مثالٌ على استعمال الدالة ()split مع تعبير نمطي:
fun main(args: Array<String>) {
val str2 = "aa132bfd4xyz"
val reg = Regex("""-?\d+(\.\d+)?""") // يطابق هذا التعبير النمطي التعابير العددية، مثل: 45
println(str2.split(reg)) // [aa, bfd, xyz]
}
انظر أيضًا
replaceAfter(): تعيد الدالةreplaceAfter()سلسلة نصية جديدة تساوي السلسلة النصية التي استُدعيت عبرها مع تعويض الجزء الذي يظهر بعد الوسيط المُمرّرdelimiterبالسلسلة النصيةreplacement. إن لم لم تحتو السلسلة النصية علىdelimiterفستعيدmissingDelimiterValueوالذي يساوي افتراضيا السلسلة النصية الأصلية.
removeSuffix(): إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremoveSuffix()تنتهي باللاحقةsuffixفستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.slice(): تعيد الدالةslice()سلسلة حروف أو سلسلة نصية جديدة تحتوي الحروف التي تنتمي فهارسها إلى الوسيط المُمرر.