Kotlin/kotlin.text/removeRange

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

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

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

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

fun CharSequence.removeRange(range: IntRange): CharSequence 

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

المعاملات

startIndex

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

endIndex

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

range

مجال من النوع Intrange يمثل المجال المراد حذفه؛ أي يحدد بداية ونهاية الجزء المراد حذفه.

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

تعاد سلسلة من المحارف أو سلسلة نصية جديدة تحوي جميع محارف سلسلة المحارف أو السلسلة النصية المعطاة باستثناء المحارف الواقعة بين المحرف ذي الفهرس startIndex والمحرف ذي الفهرس endIndex، أو الواقعة في المجال range.

أمثلة

مثالٌ على استعمال الدالة ()removeRange:

fun main(args: Array<String>) {
    val str = "wikiHsoub"

    println(str.removeRange(1, 5)) // wsoub
    println(str.removeRange(1..5)) // woub
}

انظر أيضًا

• الدالة removePrefix()‎: تحذف بادئة معينة من سلسلة من المحارف أو سلسلة نصية.

• الدالة removeSuffix()‎: تحذف لاحقة معينة من سلسلة من المحارف أو سلسلة نصية. 
• الدالة removeSurrounding()‎: تحذف بادئة ولاحقة محددتين من سلسلة من المحارف أو سلسلة نصية.  

مصادر

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