الدالة StringBuilder.subSequence()‎ في لغة Kotlin

تقتطع الدالة subSequence()‎ جزءًا محددًا من سلسلة محارف الكائن StringBuilder وتعيدها.

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

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

منصة التشغيل المطلوبة: JS.

حلت الدالة CharSequence.subSequence مكان هذه الدالة.

المعاملات

startIndex

عدد صحيح يحدد فهرس المحرف الذي يمثل بداية الجزء المراد اقتطاعه من محتوى الكائن StringBuilder.

endIndex

عدد صحيح يحدد فهرس المحرف (لا يدخل ضمن المجال) الذي يمثل نهاية الجزء المراد اقتطاعه من محتوى الكائن StringBuilder.

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

تعاد سلسلة محارف تحتوي على الجزء المقتطع من الكائن StringBuilder والمحدد بالمحرف ذي الفهرس startIndex والمحرف ذي الفهرس EndIndex (لا يدخل هذا المحرف ضمن المجال).

أمثلة

استعمال الدالة subSequence()‎ لاقتطاع جزء محدد من محتوى الكائن StringBuilder:

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.