الدالة slice()‎ في Kotlin

تقتطع الدالة slice()‎ جزءًا محدَّدًا من سلسلة المحارف أو السلسلة النصية  التي استُدعيت معها ثمَّ تعيده.

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

fun CharSequence.slice(indices: IntRange): CharSequence 

fun String.slice(indices: IntRange): String

fun CharSequence.slice(indices: Iterable<Int>): CharSequence

inline fun String.slice(indices: Iterable<Int>): String

وجود الكلمة المفتاحية inline يدل على أن هذه الدالة مباشرة (للمزيد من التفاصيل، راجع صفحة الدوال المباشرة (inline functions)).

المعاملات

indices

مجال من النوع IntRange أو كائن من النوع Iterable يحدد الجزء المراد اقتطاعه من سلسلة المحارف أو السلسلة النصية المعطاة.

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

تعاد سلسلة من المحارف أو سلسلة نصية تحوي الجزء المقتطع من سلسلة المحارف أو السلسلة النصية المعطاة المحدد بالمعامل indices المعطى.

أمثلة

مثالٌ على استعمال الدالة ()replace:

fun main(args: Array<String>) {
    val str = "wikiHsoub"

    println(str.slice(0..4)) // wikiH
}

انظر أيضًا

• الدالة split()‎: تقتطع المحارف الموجودة بين الأجزاء المتطابقة مع تعبير نمطي معين أو بين سلاسل نصية أو محارف معينة في سلسلة المحارف الممررة إليها وتعيدها في قائمة. 
• الدالة subSequence()‎‎: تجلب جزءًا محددًا يقع في سلسلة الحروف التي استٌدعيت معها.
• الدالة substring()‎: تعيد جزءًا محددًا من السلسلة النصية أو سلسلة المحارف التي استُدعيت معها.  

• الدالة replace()‎: تبدل سلسلة النصية معينة مكان كل تطابقات التعبير النمطي الذي استدعي معها في سلسلة المحارف المُمرّرة إليها أو سلسلة المحارف التي تعيدها الدالة الممررة إليها.

مصادر

• صفحة الدالة slice()‎ في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.