الدالة 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
}
انظر أيضًا
removePrefix()
: إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremovePrefix()
تبدأ بالبادئةprefix
فستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك البادئة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.
removeSuffix()
: إن كانت السلسلة النصية أو سلسلة الحروف التي استٌدعيت عبرها الدالةremoveSuffix()
تنتهي باللاحقةsuffix
فستعيد سلسلة نصية أو سلسلة حروف جديدة مع حذف تلك اللاحقة، وإلا فستعيد السلسلة النصية أو سلسلة الحروف كما هي.asSequence()
: تنشئ كائنًا من الصنفSequence
والذي يُغلّف سلسلة الحروف التي استُدعيت عبرها، لأجل استعمالها في الحلقات التكرارية.