الدالة Text.endsWith()‎ في Kotlin

تتحقق الدالة endsWith()‎ إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تنتهي بمحرف معين أو لاحقة معينة.

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

fun String.endsWith(
    suffix: String, 
    ignoreCase: Boolean = false
): Boolean

fun CharSequence.endsWith(
    char: Char, 
    ignoreCase: Boolean = false
): Boolean

fun CharSequence.endsWith(
    suffix: CharSequence, 
    ignoreCase: Boolean = false
): Boolean

المعاملات

suffix

سلسلة نصية أو سلسلة من المحارف تمثل اللاحقة التي يراد التحقق من أنَّ السلسلة النصية أو سلسلة المحارف المعطاة تنتهي بها.

char

المحرف الذي يراد التأكد من وجوده في نهاية سلسلة المحارف المعطاة.

ignoreCase

قيمة منطقية تحدد إن كان يراد تجاهل حالة المحارف أم لا أثناء الموازنة. القيمة الافتراضية هي: false أي أخذ حالة الحروف بالحسبان.

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

تعاد القيمة true إن كانت السلسلة النصية المعطاة تنتهي باللاحقة suffix أو كانت سلسلة المحارف المعطاة تنتهي باللاحقة suffix أو بالمحرف char. خلا ذلك، تعاد القيمة false.

أمثلة

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

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

    println(str.endsWith("wiki")) //  false
    println(str.endsWith("hsoub", true)) //  true
}

انظر أيضًا

• الدالة startsWith()‎: تتحقق إن كانت السلسلة النصية أو سلسلة المحارف التي استُدعيت معها تبدأ بمحرف معين أو لاحقة معينة.
• الدالة commonSuffixWith()‎: تعيد أطول لاحقة (Suffix) مُشتركة بين سلسلة المحارف التي استُدعيت معها وسلسلة المحارف المُمرّرة إليها.

• الدالة compareTo()‎: توازن بين سلسلتين نصيتين معجميًّا (lexicographically)، مع إمكانية تجاهل حالة الأحرف.
• الدالة contains()‎ إن كانت سلسلة المحارف التي استُدعيت معها تحوي المحرف أو سلسلة المحارف المُمرّرة إليها.

مصادر

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