Kotlin/kotlin.text/StringBuilder/subSequence

تعيد الدالة subSequence()‎ سلسلة حروف تحتوي جزءًا من سلسلة الحروف التي استُدعيت عبرها بداية بالفهرس المحدّد بالوسيط startIndex وانتهاءً بالفهرس المحدّد بالوسيط endIndex (غير مُتضمّن).

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

actual fun subSequence(
    startIndex: Int, 
    endIndex: Int
): CharSequence

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

سلسلة حروف.

أمثلة

استخدام الدالة subSequence()‎

تُنشِئ الشيفرة الآتية كائنًا من النوع StringBuilderباسم sb، ثم تستدعي  الدالةsubSequence()‎ عبر  sb، وتمرر إليها عددين، ثم تطبع الناتج:

fun main(args: Array<String>) {
    val sb = StringBuilder("Academy")
    
    println(sb.subSequence(2,5)) // => ade
}

أنظر أيضًا

• الخاصية length:تعيد عدد عناصر سلسلة الحروف التي استٌدعيت عبرها.
• append()‎: تضم السلسلة النصية أو الحرف أو الكائن المُمرّر إليها إلى الكائن الذي استُدعيت عبره، وفي حال تمرير عددين start و  end كوسيطين، فإنها تضم فقط جزء من السلسلة النصية المحدد بذانك الوسيطين.

• get()‎: تعيد الحرف الموجود عند الفهرس المُمرّر index في سلسلة الحروف التي استُدعيت عبرها.

• صفحة الصنف StringBuilder.

مصادر

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