التابع text.equals()‎ في لغة Kotlin

تعيد الدالة equals()‎ القيمة true في حال كان الحرف أو السلسلة النصية التي استُدعيت عبرها مساوية للحرف أو السلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط ignoreCase وإعطائه القيمة true فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط ignoreCase هي false.

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

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

تعيد الدالة equals()‎ القيمة true في حال كانت السلسلة النصية التي استُدعيت عبرها مساوية للسلسلة النصية المُمرّرة إليها. في حال تمرير الوسيط ignoreCase وإعطائه القيمة true فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط ignoreCase هي false.

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

تعيد الدالة equals()‎ القيمة true في حال كان الحرف الذي استُدعيت عبره مساويًا للحرف المُمرّر إليها. في حال تمرير الوسيط ignoreCase وإعطائه القيمة true فإنّ الدالة لن تفرق بين الحروف الصغيرة والكبيرة. القيمة الابتدائية للوسيط ignoreCase هي false.

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

قيمة منطقية.

أمثلة

استخدام الدالة equals()‎ مع السلاسل النصية

تُعرّف الشيفرة الآتية سلستين نصيتين a و b ثم تستدعي الدالة equals()‎ عبر a لمقارنتها مع b، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val a = "hsoub"
    val b = "hsouB"  
    
	print(a.equals(b)) // false
}

استخدام الدالة equals()‎ مع السلاسل النصية مع تمرير الوسيط ignoreCase

تُعرّف الشيفرة الآتية سلستين نصيتين a و b ثم تستدعي الدالة equals()‎ عبر a لمقارنتها مع b،مع تمرير القيمة true، ثم تطبع الناتج:

fun main(args: Array<String>) {    
    val a = "hsoub"
    val b = "hsouB"   
    
	print(a.equals(b, true)) // true
}

انظر أيضًا

• category: تعيد category قيمة تبيّن الفئة العامة للحرف.

مصادر

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