الدالة text.removeRange()‎ في لغة Kotlin

من موسوعة حسوب
اذهب إلى التنقل اذهب إلى البحث

تعيد الدالة removeRange()‎ السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها مع حذف جزء منها (انظر فقرة البنيةالعامة).

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

fun CharSequence.removeRange(
    startIndex: Int, 
    endIndex: Int
): CharSequence

في حال استدعاء الدالة removeRange()‎ عبر سلسلة حروف مع تمرير عددين startIndex و endIndex كوسيطين فستعيد سلسلة حروف جديدة مع حذف الحروف التي فهرسها محصور بين startIndex و endIndex. تذكر أن endIndex ليس مُتضمّنا في الجزء المحذوف.

inline fun String.removeRange(
    startIndex: Int, 
    endIndex: Int
): String

في حال استدعاء الدالة removeRange()‎ عبر سلسلة نصية مع تمرير عددين startIndex و endIndex كوسيطين فستعيد سلسلة نصية جديدة مع حذف الحروف التي فهرسها محصور بين startIndex و endIndex. تذكّر أن endIndex ليس مُتضمّنا في الجزء المحذوف.

fun CharSequence.removeRange(range: IntRange): CharSequence

في حال استدعاء الدالة removeRange()‎ عبر سلسلة حروف مع تمرير مجالrange من النوع IntRange كوسيط فستعيد سلسلة حروف جديدة مع حذف الحروف التي فهرسها ينتمي إلى المجالrange. تذكر أنّ نهاية range مُتضمّنة في الجزء المحذوف.

inline fun String.removeRange(range: IntRange): String

في حال استدعاء الدالة removeRange()‎ عبر سلسلة نصية مع تمرير مجالrange من النوع IntRange كوسيط فستعيد سلسلة نصية جديدة مع حذف الحروف التي فهرسها ينتمي إلى المجالrange. تذكر أنّ نهاية range مُتضمّنة في الجزء المحذوف.

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

سلسلة نصية أو سلسلة الحروف.

أمثلة

استخدام الدالة ()removeRange مع سلسلة نصية

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()removeRange عبرها مع تمرير عددين كوسيطين، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "hsoub wiki" 
    
println( str.removeRange (1,5) ) // h wiki 
}

استخدام الدالة ()removeRange مع سلسلة نصية مع تمرير مجال كوسيط

تعرِّف الشيفرة الآتية سلسلة نصية باسم str، ثمَّ تستدعي الدالة ()removeRange عبرها مع تمرير مجال كوسيط، ثمَّ تطبع الناتج:

fun main(args: Array<String>) {
val str = "hsoub wiki" 
    
println( str.removeRange (2..4) ) // hs wiki
}

انظر أيضًا

مصادر