الدالة removeSurrounding()‎ في Kotlin

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

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

fun CharSequence.removeSurrounding(
    prefix: CharSequence, 
    suffix: CharSequence
): CharSequence

fun String.removeSurrounding(
    prefix: CharSequence, 
    suffix: CharSequence
): String

fun CharSequence.removeSurrounding(
    delimiter: CharSequence
): CharSequence

fun String.removeSurrounding(delimiter: CharSequence): String

المعاملات

prefix

سلسلة من المحارف تمثل البادئة المراد حذفها.

suffix

سلسلة من المحارف تمثل اللاحقة المراد حذفها.

delimiter

سلسلة من المحارف تمثل البادئة واللاحقة المراد حذفها. عند استعمال هذا المعامل، يجب أن تكون البادئة واللاحقة المراد حذفهما متماثلتين.

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

تعاد سلسلة من المحارف أو سلسلة نصية جديدة تحوي سلسلة المحارف أو السلسلة النصية المعطاة بعد إزالة البادئة prefix واللاحقة suffix، أو البادئة واللاحقة delimiter منها. إن لم تكن البادئة prefix، أو اللاحقة suffix، أو البادئة واللاحقة delimiter موجودة في بداية أو نهاية أو بداية ونهاية سلسلة المحارف أو السلسلة النصية المعطاة، فستعاد نسخة عن سلسلة المحارف أو السلسلة النصية تلك دون أي تعديل.  

أمثلة

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

fun main(args: Array<String>) {
    val str = "wiki.hsoub.com"

    println(str.removeSurrounding("wiki.", ".com")) // hsoub
    println(str.removeSurrounding("xy", ".com"))    // wiki.hsoub.com
    println(str.removeSurrounding("wiki"))          // wiki.hsoub.com
}

انظر أيضًا

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

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

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

مصادر

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