الدالة 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
}

انظر أيضًا

مصادر