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

تجلب الدالة subSequence()‎‎ جزءًا محددًا يقع في سلسلة الحروف التي استٌدعيت معها.

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

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

المعاملات

startIndex

عدد صحيح يشير إلى فهرس المحرف الذي يمثل بداية الجزء المراد جلبه.

endIndex

عدد صحيح يشير إلى فهرس المحرف الذي يمثل نهاية الجزء المراد جلبه (لا يدخل هذا المحرف ضمن المجال).

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

يعاد الجزء الواقع بين الحرف ذي الفهرس startIndex والحرف ذي الفهرس endIndex في سلسلة المحارف المعطاة.

أمثلة

استعمال الدالة subSequence()‎‎ لجلب الجزء الواقع بين الحرف الرابع والحرف الثامن من سلسلة الحروف "hsoubAcademy":

fun main(args: Array<String>) {
val s = "hsoubAcademy"   
    
println(s.subSequence(3,7)) // ubAc
}

انظر أيضًا

• الخاصيّة CharSequence.length: تمثل عدد عناصر سلسلة الحروف التي استٌدعيت معها.
• الدالة ()get: تجلب العنصر ذي الفهرس الممرَّر إليها من سلسلة الحروف المستدعاة معها.

مصادر

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