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

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

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

actual fun String?.equals(
    other: String?, 
    ignoreCase: Boolean = false
): Boolean

fun Char.equals(
    other: Char, 
    ignoreCase: Boolean = false
): Boolean

المعاملات

other

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

ignoreCase

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

يعد محرفان متماثلين تمامًا بغض النظر عن حالة كل منها (محرف كبير أو صغير) إن كان أحد الخيارات التالية -على الأقل- محققًا:

• المحرفان هما نفس المحرف؛ أي أُعيدَت القيمة true عند الموازنة بينهما باستعمال المعامل ==.
• طبقت الدالة toUpperCase على كلا المحرفين قبل إجراء عملية الموازنة بينهما مثل الحالة السابقة (أي أعطت عملية الموازنة بينهما بعد ذلك القيمة true).
• طبقت الدالة toLowerCase على كلا المحرفين قبل إجراء عملية الموازنة بينهما (أي أعطت عملية الموازنة بينهما بعد ذلك القيمة true).

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

تعاد القيمة true إن كانت السلسلة النصية أو المحرف other مساويةً للسلسلة النصية أو أو مساويًا للمحرف المعطى، أو تعاد القيمة false خلاف ذلك.

أمثلة

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

fun main(args: Array<String>) {
    val a = "hsoub"
    val b = "hsouB"

    print(a.equals(b)) // false
    print(a.equals(b, true)) // true

}

انظر أيضًا

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

مصادر

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