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

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

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

fun CharSequence.removePrefix(
    prefix: CharSequence
): CharSequence

fun String.removePrefix(prefix: CharSequence): String

المعاملات

prefix

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

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

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

أمثلة

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

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

    print(str.removePrefix("wiki")) // Hsoub
    print(str.removePrefix("Wiki")) // wikiHsoub
}

انظر أيضًا

• الدالة removeSuffix()‎: تحذف لاحقة معينة من سلسلة من المحارف أو سلسلة نصية.
• الدالة removeSurrounding()‎: تحذف بادئة ولاحقة محددتين من سلسلة من المحارف أو سلسلة نصية.  
• الدالة padStart()‎: تحشو بداية سلسلة نصية أو سلسلة من المحارف بمحرف محدد.
• الدالة startsWith()‎: تتحقق إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
• الدالة commonPrefixWith()‎: تعيد أطول بادئة (prefix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.
• الدالة prependIndent()‎: تضيف بادئة معينة إلى بداية كل سطر جديد في سلسلة نصية. 
• الدالة contains()‎: تتحقق إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها.

مصادر

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